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PREFACE 


This update to the 4.2 distribution of August 1983 provides substantially improved performance, reliability, and secu- 
rity, the addition of Xerox Network System (NS) to the set of networking domains, and partial support for the VAX 
8600 and MICROVAXII. 


We were greatly assisted by the DEC UNIX Engineering group who provided two full time employees, Miriam Amos 
and Kevin Dunlap, to work at Berkeley. They were responsible for developing and debugging the distributed domain 
based name server and integrating it into the mail system. Mt Xinu provided the bug list distribution service as well as 
donating their MICROVAXII port to 4.3BSD. Drivers for the MICROVAXII were done by Rick Macklem at the Uni- 
versity of Guelph. Sam Leffler provided valuable assistance and advice with many projects. Keith Sklower coordi- 
nated with William Nesheim and J. Q. Johnson at Cornell, and Chris Torek and James O’Toole at the University of 
Maryland to do the Xerox Network Systems implementation. Robert Elz at the University of Melbourne contributed 
greatly to the performance work in the kernel. Donn Seeley and Jay Lepreau at the University of Utah relentlessly 
dealt with a miriad of details; Donn completed the unfinished performance work on Fortran 77 and fixed numerous C 
compiler bugs. Ralph Campbell handled innumerable questions and problem reports and had time left to write rdist. 
George Goble was invaluable in shaking out the bugs on his production systems long before we were confident enough 
to inflict it on our users. Bill Shannon at Sun Microsystems has been helpful in providing us with bug fixes and 
improvements. Tom Ferrin, in his capacity as Board Member of Usenix Association, handled the logistics of large- 
scale reproduction of the 4.2BSD and 4.3BSD manuals. Mark Seiden helped with the typesetting and indexing of the 
4.3BSD manuals. Special mention goes to Bob Henry for keeping ucbvax running in spite of new and improved soft- 
ware and an ever increasing mail, news, and uucp load. 


Numerous others contributed their time and energy in creating the user contributed software for the release. As always, 
we are grateful to the UNIX user community for encouragement and support. 


Once again, the financial support of the Defense Advanced Research Projects Agency is gratefully acknowledged. 


M. K. McKusick 
M. J. Karels 
J. M. Bloom 


Preface to the 4.2 Berkeley distribution 


This update to the 4.1 distribution of June 1981 provides support for the VAX 11/730, full networking and interprocess 
communication support, an entirely new file system, and many other new features. It is certainly the most ambitious 
release of software ever prepared here and represents many man-years of work. Bill Shannon (both at DEC and at Sun 
Microsystems) and Robert Elz of the University of Melbourne contributed greatly to this distribution through new 
device drivers and painful debugging episodes. Rob Gurwitz of BBN wrote the initial version of the code upon which 
the current networking support is based. Eric Allman of Britton-Lee donated countless hours to the mail system. Bill 
Croft (both at SRI and Sun Microsystems) aided in the debugging and development of the networking facilities. Den- 
nis Ritchie of Bell Laboratories also contributed greatly to this distribution, providing valuable advise and guidance. 
Helge Skrivervik worked on the device drivers which enabled the distribution to be delivered with a TU58 console cas- 
sette and RXO1 console flopppy disk, and rewrote major portions of the standalone i/o system to support formatting of 
non-DEC peripherals. 


Numerous others contributed their time and energy in organizing the user software for release, while many groups of 
people on campus suffered patiently through the low spots of development. As always, we are grateful to the UNIX 
user community for encouragement and support. 


Once again, the financial support of the Defense Advanced Research Projects Agency is gratefully acknowledged. 


S. J. Leffler 
W.N. Joy 
M. K. McKusick 


Preface to the 4.1 Berkeley distribution 


This update to the fourth distribution of November 1980 provides support for the VAX 11/750 and for the full inter- 
connect architecture of the VAX 11/780. Robert Elz of the University of Melbourne contributed greatly to this distri- 
bution especially in the boot-time system configuration code; Bill Shannon of DEC supplied us with the implementa- 
tion of DEC standard bad block handling. The research group at Bell Laboratories and DEC Merrimack provided us 
with access to 11/750’s in order to debug its support. 


Other individuals too numerous to mention provided us with bug reports, fixes and other enhancements which are 
reflected in the system. We are grateful to the UNIX user community for encouragement and support. 


The financial support of the Defence Advanced Research Projects Agency in support of this work is gratefully 
acknowledged. 


W.N. Joy 
R. S. Fabry 
K. Sklower 


Preface to the Fourth Berkeley distribution 


This manual reflects the Berkeley system mid-October, 1980. A large amount of tuning has been done in the system 
since the last release; we hope this provides as noticeable an improvement for you as it did for us. This release finds 
the system in transition; a number of facilities have been added in experimental versions (job control, resource limits) 
and the implementation of others is imminent (shared-segments, higher performance from the file system, etc.). Appli- 
cations which use facilities that are in transition should be aware that some of the system calls and library routines will 
change in the near future. We have tried to be conscientious and make it very clear where this is likely. 


A new group has been formed at Berkeley, to assume responsibility for the future development and support of a ver- 
sion of UNIX on the VAX. The group has received funding from the Defense Advanced Research Projects Agency 
(DARPA) to supply a standard version of the system to DARPA contractors. The same version of the system will be 
made available to other licensees of UNIX on the VAX for a duplication charge. We gratefully acknowledge the sup- 
port of this contract. 


We wish to acknowledge the contribution of a number of individuals to the the system. 


We would especially like to thank Jim Kulp of ITASA, Laxenburg Austria and his colleagues, who first put job control 
facilities into UNIX; Eric Allman, Robert Henry, Peter Kessler and Kirk McKusick, who contributed major new pieces 
of software; Mark Horton, who contributed to the improvement of facilities and substantially improved the quality of 
our bit-mapped fonts, our hardware support staff: Bob Kridle, Anita Hirsch, Len Edmondson and Fred Archibald, who 
helped us to debug a number of new peripherals; Ken Amold who did much of the leg-work in getting this version of 
the manual prepared, and did the final editing of sections 2-6, some special individuals within Bell Laboratories: Greg 
Chesson, Stuart Feldman, Dick Haight, Howard Katseff, Brian Kernighan, Tom London, John Reiser, Dennis Ritchie, 
Ken Thompson, and Peter Weinberger who helped out by answering questions; our excellent local DEC field service 
people, Kevin Althaus and Frank Chargois who kept our machine running virtually all the time, and fixed it quickly 
when things broke; and, Mike Accetta of Carnegie-Mellon University, Robert Elz of the University of Melbourne, 
George Goble of Purdue University, and David Kashtan of the Stanford Research Institute for their technical advice 
and support. 


Special thanks to Bill Munson of DEC who helped by augmenting our computing facility and to Eric Allman for care- 
fully proofreading the ‘‘last’’ draft of the manual and finding the bugs which we knew were there but couldn’t see. 


We dedicate this to the memory of David Sakrison, late chairman of our department, who gave his support to the estab- 
lishment of our VAX computing facility, and to our department as a whole. 


W.N. Joy 
O. Babaoglu 
R. S. Fabry 
K. Sklower 


Preface to the Third Berkeley distribution 


This manual reflects the state of the Berkeley system, December 1979. We would like to thank all the people at Berke- 
ley who have contributed to the system, and particularly thank Prof. Richard Fateman for creating and administrating a 
hospitable environment, Mark Horton who helped prepare this manual, and Eric Allman, Bob Kridle, Juan Porcar and 
Richard Tuck for their contributions to the kernel. 


The cooperation of Bell Laboratories in providing us with an early version of UNIX/32V is greatly appreciated. We 
would especially like to thank Dr. Charles Roberts of Bell Laboratories for helping us obtain this release, and acknowl- 
edge T. B. London, J. F. Reiser, K. Thompson, D. M. Ritchie, G. Chesson and H. P. Katseff for their advice and sup- 
port. 


W.N. Joy 
O. Babaoglu 


Preface to the UNIX/32V distribution 


The UNIX} operating system for the VAX*-11 provides substantially the same facilities as the UNIX system for the 
PDP*-11. 


We acknowledge the work of many who came before us, and particularly thank G. K. Swanson, W. M. Cardoza, D. K. 
Sharma, and J. F. Jarvis for assistance with the implementation for the VAX-11/780. 


T. B. London 
J. F. Reiser 


Preface to the Seventh Edition 


Although this Seventh Edition no longer bears their byline, Ken Thompson and Dennis Ritchie remain the fathers and 
preceptors of the UNIX time-sharing system. Many of the improvements here described bear their mark. Among many, 
many other people who have contributed to the further flowering of UNIX, we wish especially to acknowledge the con- 
tributions of A. V. Aho, S. R. Bourne, L. L. Cherry, G. L. Chesson, S. I. Feldman, C. B. Haley, R. C. Haight, S. C. 
Johnson, M. E. Lesk, T. L. Lyon, L. E. McMahon, R. Morris, R. Muha, D. A. Nowitz, L. Wehr, and P. J. Weinberger. 
We appreciate also the effective advice and criticism of T. A. Dolotta, A. G. Fraser, J. F. Maranzano, and J. R. 
Mashey; and we remember the important work of the late Joseph F. Ossanna. 


B. W. Kernighan 
M. D. Mcllroy 


+ UNIX is a trademark of AT&T Bell Laboratories. 
*V AX and PDP are Trademarks of Digital Equipment Corporation. 


INTRODUCTION TO USER’S REFERENCE MANUAL 


The documentation has been reorganized for 4.3BSD in a format similar to the one used for the Usenix 
4.2BSD manuals. It is divided into three sets; each set consists of one or more volumes. The abbreviations 
for the volume names are listed in square brackets; the abbreviations for the manual sections are listed in 
parenthesis. 


I. User’s Documents 

User’s Reference Manual [URM] 
Commands (1) 
Games (6) 
Macro packages and language conventions (7) 

User’s Supplementary Documents [USD] 
Getting Started 
Basic Utilities 
Communicating with the World 
Text Editing 
Document Preparation 
Amusements 


II. Programmer’s Documents 

Programmer’s Reference Manual [PRM] 
System calls (2) 
Subroutines (3) 
Special files (4) 
File formats and conventions (5) 

Programmer’s Supplementary Documents, Volume 1 [PS1] 
Languages in common use 
General Reference 
Programming Tools 
Programming Libraries 

Programmer’s Supplementary Documents, Volume 2 [PS2] 
Documents of Historic Interest 
Other Languages 
Database Management 


I. System Manager’s Manual [SMM] 
Maintenance commands (8) 
System Installation and Administration 
Supporting Documentation 


References to individual documents are given as ‘‘volume:document’’, thus USD:1 refers to the first docu- 
ment in the ‘‘User’s Supplementary Documents’’. References to manual pages are given as 
““name(section)’’ thus sh(1) refers to the shell manual entry in section 1. 


The manual pages give descriptions of the publicly available features of the UNIX/32V7 system, as extended 
to provide a virtual memory environment and other enhancements at the University of California. They do 


+ UNIX is a trademark of AT&T Bell Laboratories. 
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not attempt to provide perspective or tutorial information about the UNIX operating system, its facilities, or 
its implementation. Various documents on those topics are contained in the ‘‘UNIX User’s Supplementary 
Documents’’ (USD), the “‘UNIX Programmer’s Supplementary Documents’’ (PS1 and PS2), and ‘‘UNIX 
System Manager’s Manual’? (SMM). In particular, for an overview see ““The UNIX Time-Sharing Sys- 
tem’’ (PS2:1) by Ritchie and Thompson; for a tutorial see ‘“UNIX for Beginners’? (USD:1) by Kernighan, 
and for an guide to the new features of this virtual version, see “‘Berkeley Software Architecture Manual 
(4.3 Edition)’’ (PS1:6). 

Within the area it surveys, this volume attempts to be timely, complete and concise. Where the latter two 


objectives conflict, the obvious is often left unsaid in favor of brevity. It is intended that each program be 
described as it is, not as it should be. Inevitably, this means that various sections will soon be out of date. 


Commands are programs intended to be invoked directly by the user, in contrast to subroutines, that are 
intended to be called by the user’s programs. User commands are described in URM section 1. Commands 
generally reside in directory 


(for bin ary programs). Some programs also reside in /usr/bin, /usr/ucb, or /usr/new, to save space in 
bin. /bin. These directories are searched automatically by the command interpreters. 


Games have been relegated to URM section 6 and /usr/ games, to keep them from contaminating the more 
staid information of URM section 1. 


Miscellaneous collection of information necessary for writing in various specialized languages such as 
character codes, macro packages for typesetting, etc is contained in URM section 7. 


System calls are entries into the UNIX supervisor. The system call interface is identical to a C language 
procedure call; the equivalent C procedures are described in PRM section 2. 


An assortment of subroutines is available; they are described in PRM section 3. The primary libraries in 
which they are kept are described in intro(3). The functions are described in terms of C; those that will 
work with Fortran are described in intro (3f). 


PRM section 4 discusses the characteristics of each system ‘‘file’’ that refers to an I/O device. The names 
in this section refer to the DEC device names for the hardware, instead of the names of the special files 
themselves. 


The file formats and conventions (PRM section 5) documents the structure of particular kinds of files; for 
example, the form of the output of the loader and assembler is given. Excluded are files used by only one 
command, for example the assembler’s intermediate files. 


Commands and procedures intended for use primarily by the system administrator are described in SMM 
section 8. The commands and files described here are almost all kept in the directory etc. /etc. 


Each section consists of independent entries of a page or so each. The name of the entry is in the upper cor- 
ners of its pages, together with the section number, and sometimes a letter characteristic of a subcategory, 
e.g. graphics is 1G, and the math library is 3M. Entries within each section are alphabetized. except for 
PRM section 3f which appears after the rest of PRM section 3. The page numbers of each entry start at 1; it 
is infeasible to number consecutively the pages of a document like this that is republished in many variant 
forms. 


All entries are based on a common format; not all subsections always appear. 


The ame name subsection lists the exact names of the commands and subroutines covered under the 
entry and gives a short description of their purpose. 


The synopsis summarizes the use of the program being described. A few conventions are used, par- 
ticularly in the Commands subsection: 


words are considered literals, and are typed just as they appear. 


Square brackets [ ] around an argument show that the argument is optional. When an argument 
is given as ‘‘name’’, it always refers to a file name. 


Ellipses “*...’’ are used to show that the previous argument-prototype may be repeated. 
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A final convention is used by the commands themselves. An argument beginning with a minus 
sign ‘‘—’’ usually means that it is an option-specifying argument, even if it appears in a posi- 
tion where a file name could appear. Therefore, it is unwise to have files whose names begin 
with ‘‘—’’. 

The description subsection discusses in detail the subject at hand. 

The files subsection gives the names of files that are built into the program. 

A. see also subsection gives pointers to related information. 

A 


subsection discusses the diagnostic indications that may be produced. Messages that are intended to 
be self-explanatory are not listed. 


The bugs subsection gives known bugs and sometimes deficiencies. Occasionally the suggested fix 
is also described. 


At the beginning of URM is a table of contents, organized by section and alphabetically within each sec- 
tion. There is also a permuted index derived from the table of contents. Within each index entry, the title 
of the writeup to which it refers is followed by the appropriate section number in parentheses. This fact is 
important because there is considerable name duplication among the sections, arising principally from com- 
mands that exist only to exercise a particular system call. 


HOW TO GET STARTED 


This section sketches the basic information you need to get started on UNIX; how to log in and log out, 
how to communicate through your terminal, and how to run a program. See “‘UNIX for Beginners’’ in 
(USD:1) for a more complete introduction to the system. 


Logging in. Almost any ASCII terminal capable of full duplex operation and generating the entire char- 
acter set can be used. You must have a valid user name, which may be obtained from the system adminis- 
tration. If you will be accessing UNIX remotely, you will also need to obtain the telephone number for the 
system that you will be using. 


After a data connection is established, the login procedure depends on what type of terminal you are using 
and local system conventions. If your terminal is directly connected to the computer, it generally runs at 
9600 or 19200 baud. If you are using a modem running over a phone line, the terminal must be set at the 
speed appropriate for the modem you are using, typically 300, 1200, or 2400 baud. The half/full duplex 
switch should always be set at full-duplex. (This switch will often have to be changed since many other 
systems require half-duplex). 


When a connection is established, the system types “‘login:’’; you type your user name, followed by the 
“‘return’’ key. If you have a password, the system asks for it and suppresses echo to the terminal so the 


password will not appear. After you have logged in, the ‘‘return’’, “‘new line’’, or ‘‘linefeed’’ keys will 
give exactly the same results. A message-of-the-day usually greets you before your first prompt. 


If the system types out a few garbage characters after you have established a data connection (the ‘‘login:”’ 
message at the wrong speed), depress the ‘‘break’’ (or ‘‘interrupt’’) key. This is a speed-independent signal 
to UNIX that a different speed terminal is in use. The system then will type ‘‘login:,’’ this time at another 
speed. Continue depressing the break key until “‘login:’’ appears clearly, then respond with your user 
name. 


For all these terminals, it is important that you type your name in lower-case if possible; if you type upper- 
case letters, UNIX will assume that your terminal cannot generate lower-case letters and will translate all 
subsequent lower-case letters to upper case. 


The evidence that you have successfully logged in is that a shell program will type a prompt (“‘$’’ or ‘*%’’) 
to you. (The shells are described below under ‘‘How to run a program.’’) 


For more information, consult fsef(1), and stty(1), which tell how to adjust terminal behavior; getty(8) dis- 
cusses the login sequence in more detail, and fty(4) discusses terminal I/O. 
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Logging out. There are three ways to log out: 


By typing “‘logout’’ or an end-of-file indication (EOT character, control-D) to the shell. The shell 
will terminate and the “‘login:’’ message will appear again. 


You can log in directly as another user by giving a login(1) command. 


If worse comes to worse, you can simply hang up the phone; but beware — some machines may lack 
the necessary hardware to detect that the phone has been hung up. Ask your system administrator if 
this is a problem on your machine. 


How to communicate through your terminal. When you type characters, a gnome deep in the system 
gathers your characters and saves them in a secret place. The characters will not be given to a program 
until you type a return (or newline), as described above in Logging in. 


UNIX terminal I/O is full-duplex. It has full read-ahead, which means that you can type at any time, even 
while a program is typing at you. Of course, if you type during output, the printed output will have the 
input characters interspersed. However, whatever you type will be saved up and interpreted in correct 
sequence. There is a limit to the amount of read-ahead, but it is generous and not likely to be exceeded 
unless the system is in trouble. When the read-ahead limit is exceeded, the system throws away all the 
saved characters (or beeps, if your prompt was a ‘*%’”). 


The delete (DEL) character in typed input kills all the preceding characters in the line, so typing mistakes 
can be repaired on a single line. Also, the backspace character (control-H) erases the last character typed. 
Tset(1) or stty(1) can be used to change these defaults. Successive uses of backspace erases characters back 
to, but not beyond, the beginning of the line. DEL and backspace can be transmitted to a program by pre- 
ceding them with “‘\’’. (So, to erase ‘‘\’’, you need two backspaces). 


An interrupt signal is sent to a program by typing control-C or the ‘“break’’ key which is not passed to 
programs. This signal generally causes whatever program you are running to terminate. It is typically used 
to stop a long printout that you do not want. However, programs can arrange either to ignore this signal 
altogether, or to be notified when it happens (instead of being terminated). The editor, for example, catches 
interrupts and stops what it is doing, instead of terminating, so that an interrupt can be used to halt an editor 
printout without losing the file being edited. The interrupt character can also be changed with tset(1) or 
stty(1). 

It is also possible to suspend output temporarily using *S (control-S) and later resume output with “Q 
(control-Q). Output can be thrown away without interrupting the program by typing “O (control-O); see 
tty(4). 

The quit signal is generated by typing the AsciI FS character. (FS appears many places on different termi- 
nals, most commonly as control-\ or control- |.) It not only causes a running program to terminate but also 
generates a file with the core image of the terminated process. Quit is useful for debugging. 


Besides adapting to the speed of the terminal, UNIX tries to be intelligent about whether you have a termi- 
nal with the newline function or whether it must be simulated with carriage-return and line-feed. In the lat- 
ter case, all input carriage returns are turned to newline characters (the standard line delimiter) and both a 
catriage return and a line feed are echoed to the terminal. If you get into the wrong mode, the reset(1) com- 
mand will rescue you. If the terminal does not appear to be echoing anything that you type, it may be stuck 
in “‘no-echo’’ or ‘‘raw’’ mode. Try typing “‘(control-J)reset(control-J)’’ to recover. 


Tab characters are used freely in UNIX source programs. If your terminal does not have the tab function, 
you can arrange to have them turned into spaces during output, and echoed as spaces during input. The sys- 
tem assumes that tabs are set every eight columns. Again, the fset(1) or stty(1) command can be used to 
change these defaults. Tset(1) can be used to set the tab stops automatically when necessary. 


How to run a program; the shells. When you have successfully logged in, a program called a shell is lis- 
tening to your terminal. The shell reads typed-in lines, splits them up into a command name and argu- 
ments, and executes the command. A command is simply an executable program. The shell looks in sev- 
eral system directories to find the command. You can also place commands in your own directory and have 
the shell find them there. There is nothing special about system-provided commands except that they are 
kept in a directory where the shell can find them. 
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The command name is always the first word on an input line; it and its arguments are separated from one 
another by spaces. 


When a program terminates, the shell will ordinarily regain control and type a prompt at you to show that it 
is ready for another command. 


The shells have many other capabilities, that are described in detail in sections sh(1) and csh(1). If the 
shell prompts you with ‘‘$’’, then it is an instance of s(1) the standard shell provided by Bell Labs. If it 
prompts with ‘‘%’’ then it is an instance of csh(1), a shell written at Berkeley. The shells are different for 
all but the most simple terminal usage. Most users at Berkeley choose csh(1) because of the 


mechanism and the lias feature, that greatly enhance its power when used interactively. 


also supports the job-control facilities; see csh(1) or the Csh introduction in USD:4 for details. 


You can change from one shell to the other by using the 


command, which takes effect at your next login. 


The current directory. UNIX has a file system arranged as a hierarchy of directories. When the system 
administrator gave you a user name, they also created a directory for you (ordinarily with the same name as 
your user name). When you log in, any file name you type is by default in this directory. Since you are the 
owner of this directory, you have full permission to read, write, alter, or destroy its contents. Permissions 
to have your will with other directories and files will have been granted or denied to you by their owners. 
As a matter of observed fact, few UNIX users protect their files from perusal by other users. 


To change the current directory (but not the set of permissions you were endowed with at login) use cd(1). 


Path names. To refer to files not in the current directory, you must use a path name. Full path names 
begin with ‘‘/’’, the name of the root directory of the whole file system. After the slash comes the name of 
each directory containing the next sub-directory (followed by a ‘‘/’’) until finally the file name is reached. 
For example, /usr/tmp/filex refers to the file filex in the directory tmp; tmp is itself a subdirectory of 
usr; usr springs directly from the root directory. 


If your current directory has subdirectories, the path names of files therein begin with the name of the sub- 
directory with no prefixed ‘‘/’’. 


A path name may be used anywhere a file name is required. 


Important commands that modify the contents of files are cp(1), mv(1), and rm(1), which respectively 
copy, move (i.e. rename) and remove files. To find out the status of files or directories, use /s(1). See 
mkdir (1) for making directories and rmdir(1) for destroying them. 


For a fuller discussion of the file system, see ‘‘A Fast File System for UNIX’? (SMM:14) by McKusick, 
Joy, Leffler, and Fabry. It may also be useful to glance through PRM section 2, that discusses system calls, 
even if you do not intend to deal with the system at that level. 


Writing a program. To enter the text of a source program into a UNIX file, use the editor ex(1) or its dis- 
play editing alias vi(1). (The old standard editor ed(1) is also available.) The principal languages in UNIX 
are provided by the C compiler cc(1), the Fortran compiler f77(1), and its derivatives efl(1) and ratfor(1), 
the Pascal compiler pc(1), and interpreter pi(1), and the Lisp system /isp(1). User contributed software in 
the latest release of the system supports APL, B, the Functional Programming language, and Icon. Refer to 
apl(1), b(1), fp(), and icon(1), respectively for more information about each. After the program text has 
been entered through the editor and written to a file, you can give the file to the appropriate language pro- 
cessor as an argument. The output of the language processor will be left on a file in the current directory 
named ‘‘a.out’’. If the output is precious, use mv(1) to move it to a less exposed name after successful 
compilation. 


When you have finally gone through this entire process without provoking any diagnostics, the resulting 
program can be run by giving its name to the shell in response to the shell (“‘$’’ or ‘*%’’) prompt. 


Your programs can receive arguments from the command line just as system programs do, see ‘‘UNIX Pro- 
gramming - Second Edition’’ (PS2:3), or for a more terse description execve(2). 
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Text processing. Almost all text is entered through the editor ex(1) (often entered via vi(1)). The com- 
mands most often used to write text on a terminal are: cat(1), more(1), and nroff(1). 


The cat(1) command simply dumps ASCII text on the terminal, with no processing at all. More(1) is useful 
for preventing the output of a command from scrolling off the top of your screen. It is also well suited to 
perusing files. Nroff(1) is an elaborate text formatting program. Used naked, it requires careful fore- 
thought, but for ordinary documents it has been tamed; see me(7) and ms(7). 


Troff(1) prepares documents for a Graphics Systems phototypesetter or a Versatec Plotter; it is similar to 
nroff(1), and often works from exactly the same source text. It was used to produce this manual. 


Script(1) lets you keep a record of your session in a file, which can then be printed, mailed, etc. It provides 
the advantages of a hard-copy terminal even when using a display terminal. 


Status inquiries. Various commands exist to provide you with useful information. w(1) prints a list of 
users currently logged in, and what they are doing. date(1) prints the current time and date. /s(1) will list 
the files in your directory or give summary information about particular files. 


Surprises. Certain commands provide inter-user communication. Even if you do not plan to use them, it 
would be well to learn something about them, because someone else may aim them at you. 
To communicate with another user currently logged in, write(1) or talk(1) is used; mail(1) will leave a 
message whose presence will be announced to another user when they next log in. The write-ups in the 
manual also suggest how to respond to the these commands if you are a target. 


If you use csh(1) the key *Z (control-Z) will cause jobs to ‘‘stop’’. If this happens before you learn about 
it, you can simply continue by saying ‘‘fg’’ (for foreground) to bring the job back. 


CONVERTING FROM 4.2BSD SYSTEMS 

A detailed list of changes from the 4.2BSD to the 4.3BSD distributions is contained in “‘Bug Fixes and 
Changes in 4.3BSD’’ (SMM:12), and ‘‘Changes to the Kernel in 4.3BSD’’ (SMM:13). Detailed conver- 
sion procedures are described in ‘‘Installing and Operating 4.3BSD on the VAX’? (SMM:1); it also dis- 
cusses changes from pre-4.2BSD systems. 
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whoami wg 6 ww we we we eee ee we ee ee we ee ~~ ©Cprint effective current user id 


whois ce ee ee we ww we ew ew ee ee ee © DARPA Internet user name directory service 
window Cw ee ew ee ee we ew ee ee ww we ee ee) 6WWindOW ENVironment 
write SB Sa BSE eG Oe a OA le OA Ee ee, “Welte: tovaniother user 
xsend SP pe Dee Soka ear Se) BE Oe ae eS te BE ES, eel ecco 0, ae the Se Gee Ge teh th Gy ee By w SECTEL Mall. 
xstr cee ee we we ww ee ee © 6eXtract Strings from C programs to implement shared strings 


YaCC gw ew ww ee ee we ww ww ee we ww we we we ~~) 6et another compiler-compiler 
be repetitively affirmative 


yes et eae Be BE te CS Cae ene ie eg By UG Awe ig ie_Sa ome 


2. System Calls 


4.3BSD 


intro cee ee ee ew ww we we we ~~ «introduction to system calls and error numbers 
accept 6 6 6 ww ee ew ee ee ee ww ww we ew ee © accept a connection on a socket 
access ce ew ee ee ww ww ww we we ww ee © determine accessibility of file 
acct Bee BE ee Mae BO Jal le ed ee eel ee a a a g's “tum accounting on or off 
adjtime cee ee ee we ee ee ~~ 6COrrect the time to allow synchronization of the system clock 
bind 2 6 ww ee ee we ee we ww we ee ww ww ee ee ©) dnd A name to a Socket 
brk ce ee we ww we ew ew ww ww we ee ew we ew ee © 6UChange data segment size 
chdir ce ee we eee ee we ww ww ee ee © hChange current working directory 
chmod ot ei ie BOs ale BOSE NG Gare) GS CeO. wal, By Slate we cs Se wt “Changemodeor ile 


chown ce ee eee we we ew ee ee we ew ee ee © 6Change owner and group of a file 
chroot 2... 6 we ee ee ee we ww ee ee ee we we ee ee © 6Change root directory 


close Pky Pena 004 WS Pe eee Bene Se aie Ma eed Se Tan Sai os ae ew, we Selete-ardescriptor 
connect we ew we ew we ww ww ww ew ew ew ww we he he ~~ «6initiate a connection on a socket 
creat Sir tay ile igi lea Wie We we RR owt Hom? Ge Ge wee bn Wi eS eee a ky RO Re BO ae ee CTE atea new ‘file 


dup 6 ww ww ee ee ee ee ee ee we we we ee ee ee ee © duplicate a descriptor 
CXCCVE! <6. tS Ai Hee See Se ae ede ee wei Mie a el Oe set ae oh i eee execute adie 
CXIt- fe 8 ee wh, es BN ae Me Se el 6 oo s,  tetMnate aprocess 
Tenth, “0205. wet Bete AE ee Ae Ee as Sh eee eh GS eee ky te ee We OS we ee hile control 
flock ce ee ee ee ww we ew we ee ~~) apply or remove an advisory lock on an open file 
fork 2. 2 1 wee ee wwe we ee ee ew ww we ew ee ee ee ee) Create ANEW Process 
fsync 6 ww ww ww ee ee ww we ee © SYNchronize a file’s in-core state with that on disk 
getdtablesize ce ew ee ee we ww ee ee ee © 6get descriptor table size 
getgid ay Re aan Se ae Seca ee a ee ee a wer Soe eae ees. @ ev, Beteroup identity. 


getgroupSs 6 ww ww ee ee ee ee ee ee we ew ee ee ew ee ~~) 6get group access list 
gethostid 2... 1 1 ee ew ew ee ew ew we ee © 6 get/set unique identifier of current host 


gethostname . 1. 1 ww ww ee ee ee we ee ew we ee ~~ 6 get/Set name of current host 
getitimer Ce ee ee ee ee we ee we ee we ee © 6get/set value of interval timer 
getpagesize ww ww ee we ew eh we we ww we ww www we we © get System page Size 
getpeername «ww 1 we ee ee ee ee we we we we ee ee © 6get name Of connected peer 


getpSrp ww ew ww ee ee ew ee ee ew we we ee ee ew ee ee ~)©6get process Group 


getpid ce ee ew wee we we we we ee ee we ee ~~ 6get process identification 
getpriority ce ee ee we ww we we we ww we ee © 6get/Set program scheduling priority 
getrlimit eee ee ew ww we ee ee © dCOntrO] MaximuM system resource consumption 
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getrusage ee ee ew ee ee ew ee we we ee © 6get information about resource utilization 
getsockname iy tS are OR alee ae MW RE OE Ha eee A a AO ee i Se ogetsocketname 
getsockopt ee ew ww ee we ew ww we ew ee ee © 6get and Set options on sockets 
gettimeofday Be eA Ss we ce dS Be Se oe ee Ow A ee ee §©—Bet/Setdateand time 


get user identity 
ioctl oh teehee Baa Ve Meee tid aa Wh bb Oh Me Pe ad See ot Bh WE Seek, eee, - wCONtrol. device 
send signal to a process 


POUIG: ue slemj eee Sr oe ees te Ga ee a er le Se, Boe ee BR Se Res 


killpg Ce ew we we ee we we ww ww we ee ee ~~ Send Signal to a process group 
link Ce ee ee ee eee we ew we ee ee ee ew we ee ©) d6umake a hard link to a file 
listen cee ee ew ee ee ee ww we ew we ee ~~ «Listen for connections on a socket 
Iseek oa we ee a a ae ah eae ee ee Soe es oe Sos «MOVE Tead/write:pointer 
mkdir eo wher Wows Ai rete hes Mh od ah fe Mie a le ron i oh a) ions oe ae oe maKe.a directory: file 


mknod «2 1 1 we ee ee ww eee ee we we we eee ee ee ee ©)©6make a Special file 
mount . 2... 6 1 ee ee ee ee we eee ew ee eee) ©)©6mount or remove file system 
open 2... ee ee ee ee ee ee © hUOpena file for reading or writing, or create a new file 
pipe 2... 2. 1 ee ee ww ee ew we we ee © OCreate an interprocess communication channel 
profil 2. 2... eee ee ee ee ee ew ew ee ee ee ee ee) 6eXECUtION time profile 
ptrace eee we ee ww ww we ww wt ww ww th ww ww whl hw he) 6process trace 
quota ee we we ee ee ee we we we wee ee ww ee ee ©) 6manipulate disk quotas 
read St Seta: Stare weitutes Scns al teeta ale) ch Oat ts St Je lnc) van Ss Aerie eh Meh A Geutlee Gove a sh wes CAC ANpUt 
readlink =. 6 ww ww ee ee ee we ee we ww we ee © «read Value of a symbolic link 
reboot 2. 6 1 we ee we we we ew we ww we we ew we ee © reboot System or halt processor 
Tecv ce ww ew ee ew we ww ww ee we ww we ee 6reCeive a Message from a socket 
rename «ww wwe ee ee ee ee ee we ew we ee ee © d6Change the name of a file 


rmdir ce ee ee ee ee we we eee ee we ee ee ee ~)©6remove a directory file 
select ce ee ee eee ee ew we wee ee ew ee © 6SYNchronous I/O multiplexing 
send cee ee ew ee we ew ww ew ee we ww ee ee © 6Send a message from a socket 


setgroups Bo URN Hee ih ee else re: eee BOBO Se MR, ote, Ww ee Seep - SEL Broupaccess list 
SCtPOIP sk ee ee ee A a ee A es Setiprocess group 


setquota ee ee ee ee ee we we ww ww ew ee ~~ enable/disable quotas on a file system 
setregid ce ee ee ee we ew ew ww we ee ee ~~ Set real and effective group ID 
setreuid ce ee ee ee ee ew ww ww we ee ee ~~ Set real and effective user ID’s 
shutdown «ww ww we ee ew we ee ee © OShut down part of a full-duplex connection 
sigblock Bie ESBS A RA TS AE BR OES ek SOG Ee SE Sek ee ee a oS & block: signals 


sigpause «ww we ew ew ew ee ee © atomically release blocked signals and wait for interrupt 
sigreturn b Behe oS Abe eed, ue Sew se es a Oe wea Se eh aS. UMetumeronmy sienal 


sigsetmask ee we ee we ee ww ww wee ee we ee ~~ SE Current Signal mask 
sigstack ce ee ee ew ew we ee we ww ew ew ee © Set and/or get signal stack context 
sigvec Ce ee ee ee eee ee eee ee we we we ~~ 6SOftWare Signal facilities 
socket Ce ee ee ee ee eee wee wee ee ~~ Create an endpoint for communication 
socketpair ee ee ee ee we ee ee ee we ew ee ~~ «Create a pair of connected sockets 
stat Birney eek i aia hs teh Sivigt Wer WO Teb Siew? ke Ses ee. Ben sae a ae Oe eS Ge ey we, oe Bethle:-status 
swapon ce ee ee ew ww we we ee © add a swap device for interleaved paging/swapping 
symlink Ce ee we ee ew we ee ww ww we ee ee 6 ©)6omake symbolic link to a file 


update super-block 


syscall Se Gare? sal SS cette: aPrel URt tle. cd ee pal as, AL) HELGE en BP Goa we ee ndirecesystem:call 
truncate 6 ww we ee ew ww we ee ww ew ew ee ~~ ©dtruncate a file to a specified length 
umask ce ee ee wee ee we we we ee ee ee we we ee ~~ SO file Creation mode mask 


unlink SF ee AS) hte Gal Lem stk al Se ASS pa ee we Oe ae Ga es Be —TEMOVe directory. entry: 
set file times 


utimes Soa Gee es ge das Tat SE vw Fe Se te, Sak paces tay NEG we Re Said oR. ie Tat a 
vfork ee ee ee we ew ee ew ee ee ©) 6d Spawn new process in a virtual memory efficient way 
vhangup cee ee ee ew we ee ew ~~ Virtually “‘hangup’’ the current control terminal 


wait for process to terminate 
write output 


Walt © Seu eeo car fg eh Gate) Sad 8 a AE oe od 8 ea Sk Ae, 


WINE 2) as ay ede oS aa A Sw a pa eee, i ee Baoan B 
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intro ee ee ee ee ww eee we we ew ee ~~ 6introduction to C library functions 
AbOTE. ies. Bass wi Bo eee Bh Gee aE Ge ee a oe Poa ss Gee Seenefaté:a fault 
abs www we ww ee ee we wee we ew we we we ew ee ee ~~ Integer absolute Value 


alarm ce ee we ee ee ew we ww ww we ee © 6SChedule signal after specified time 
asinh Ce ew ee ee we ee ee ee we wwe ee ee ~~ inverse hyperbolic functions 
assert Bote ope bs ae Bea Rp VSD ee BE a Sees ce, CaO: US Sed, “eer owe) Gerd. ace FprOgram:verification 
atof ww ee ee ee ee ee eee wee we ee © Convert ASCII to numbers 
bstring ee we ww ew ew we we ew ew ee eh © ~— «Cit and byte string operations 
byteorder cee ee we ew ww ee ee © 6CONVErt Values between host and network byte order 


crypt IE. 2 ele Seal Aid Melek ge Ba PRs ok Cee Mole Be See Aw Se ace a. (DESencrypiion 
ctime See ee eee ee we ee ww ew ww we ew ee ©) 6CONVErt date and time to ASCII 


ctype Ce ee ee we eee wee wee ee ee ~~ dcCharacter classification macros 
curses ee ee ee ee we ew ee ew ee ~~ «Screen functions with ‘‘optimal’’ cursor motion 
dbm ee ew ew we we we ee we ew ww we ee ee © data base subroutines 
directory Be 6 SB Rls We ew le We SE es LS ara ee & wy Soe ew directory operations 
COVE: neces 8S teh Sag SAE ay a ee 8 Rs LS ape” ae So Sw See se, OUTPUt Conversion 
end Ce ee ee eee ee ww ww wee ee ee ee ee ee ~ Mast locations in program 
CEE a te SEY cette? See Sd Sap Mey tected SB Sea tea ow ee ea as Oe Od od, CETTOETUNCHIONS 
execl Say Wl ails BAe eee Ss wer oy WOM ee ue oo eas, ee ae “o, JEXECUIE ane 
exit cee ee we ee ww we ew ee ~~ «cterminate a process after flushing any pending output 
exp ce ee ew ee ee we we we we ee ee ee ee ee) 6eXpONENtial, logarithm, power 
fclose wo tel [Be ca en el Bw es Se a Bk re ee ghd aces cae 6. “Close orflush-a stream 


ferror ww we ee ee ee ee ee ee we ee ee ee ~~ Stream Status iNqUIries 
floor ......+.+.+.+.+.+. +... absolute value, floor, ceiling, and round-to-nearest functions 
fOPED? ne sh ee we pe eg ele a ee a a ee Gi, Ge ee Ope a stream 
fread ce ee we ee eee ee we ww ee ee ee ee ~~ dCUffered binary input/output 
frexsp 2. we ewe ee ee we ee ee ee ee ee ~~ «Split into mantissa and exponent 
fseek Bilis JS gh ee tale BO pices Bal C50 aw esd Sa Vek We De S28, eae ke eo te: TEpOsiton’a stream 
getc ew ew ww we we ew ww we ew ee ee © 6oget character or word from stream 
getdisk ee we ee ee ee we we we we ee ee © 6oget disk description by its name 
getenVv 6 ww ee ee ee ee ee ee ee ee ew we ee © 6vValue for environment name 
getfsent 2... 1. ee eee eee ee eee we ee ~~ get file system descriptor file entry 
getgrent 2. 1. 1 ew ww ee ee ee ew ee te we we ee ee ee ~~ 6get group file entry 
gethostbyname . . 1. 1 1 ee ww ee ee ee we we ee ew ee ©) 6get network host entry 
getlogin Se eis. be Byte acs Ne BS ee hee Swi ia eh ee Sd get losin name 
getnetent a ee Soe 8 ce He Se OR) ke WE Wa Re ee oe oe ae s, get network‘entry 
getopt 2 6 6 we ee we ee ee ee ee we ew we ww we ee © get option letter from argv 
getpass ot ee mn Bh ee Ie wd tae, Stee iw ee MR aia aie te os te Oe, ~ Tead a password 
getprotoent ce ee ee ee we we we ee ee we we ee ee ~~ 6get protocol entry 
getpw dy Se ee Bae SR Pe a ee ee ee Gk Se BET Mamestromiiid 
getpwent BLS ces SR oe ay a Oe Ree re OR a wo ere wa ee, eT password Nle-entry 
gets Sie teh las GE aw Bw Oe Se ee WE ee Se Gee a we Soe a Se Seharstringe froma stream 


getservent be Bede 3. vent ed ee ee Oe oh oe es a Se eae a ee ee 4  BOUSETVICE entry. 
getttyent eB ee Rh AE Se Se OR Ee WE a Oe eer RS eae ace “et ttys:fileentry 
getusershell Bity eed Bowe wle BS wl Boe eS Ree er dS 4S. oes ~~ Pet legal user:shells 
getwd ee ee ww ew ww ee we we ee © 6get current working directory pathname 


hypot cee ee ee ee we ew ew we we ee ee © dEvcclidean distance, complex absolute value 
ieee cee ee ee ee ee we ee ww we ee © 6COPYSIQN, remainder, exponent manipulations 
inet ce ee ee ee ew we we ww ww we ee © dInternet address manipulation routines 
infman ........... =... signals invalid floating-point operations on a VAX (temporary) 
initgroups ee ew we ee ee ee ww ww we we we ee ~~ initialize group access list 
iInsque «ww ww ww we we we ww we we ww ew ee ~~ 6insert/remove element from a queue 
4ON dese ee Be Sar SOR er Wow a ay ea ee ra Se eo Seow ae ey ey “DESSel functions 
lgamma oie! Pie Sid Whe a ge a Eola co Dee WT ee Set a o> ete ee, OS Bamma-function. 
1ib2648 ee ee ee we we ew we ew 6 ©~©— OSubroutines for the HP 2648 graphics terminal 
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malloc Bylo PW Sle Bw en A ee eee hd ws — memory’allocator 
math ce ee ee ew ww we ee we we ee ~~ introduction to mathematical library functions 
mktemp .. 1... ee ee ww eee ee ew we ew ee ee eh eh ©)©6make a unique file name 
monitor «6 6 6 wwe ee we ee ee ww ww we ww we ee ~~ dprepare execution profile 
mp ce ee we we ee ee ww we ww we ee ee ©6©~© domuitiple precision integer arithmetic 
ndbm ww ww ee ew ee ee we ee we we we ww ww ee ee ~~ data base subroutines 


nice ase gy WE ey a IETS GP Be eS ORO aT eae OR eS. & “ose we We SEP programipriority. 
nlist 6 ww we ee ee ee ee ee ee we ee ee ee ee ©) 6get entries from name list 
ns ce eee eee we ww ew we we we ew ee e)©)©6Xerox NS(tm) address conversion routines 
pause BES Ee eh ee, 8S GA ete Se ek Re oe SS ee ee BSS ee we 9 StOp Unt Sienal 
perror 8 ie OR 2 SO ak ae es ire oS A ee Se ee OS YStEMMErrOr Messages 
plot 3th eh oa on Forge to eh sgt ey oct See alee cta ot Sid teh coh Ow Sat tas A, veil ee ves wt 2 BAphics-intertace 
popen . 2... we ee ee we we ee ee we ee ew ee ee ~~ Initiate I/O to/from a process 
printf ee we eee ee ee ww ww ee ee ee © 6 formatted output conversion 
psignal bo Gear wore es PRO a OP eas aa oe eS aime wee Zee 2S yStem Signal messages 


pute . ww wee ee ee we ee ee we ew ee ee © dOput character or word on a stream 
puts 6 we we we ew we ew ee ee ew ew we ee ee ©) 6Oputa String on a stream 
qsort Se RP A Re SRA Ro tee Go er SB eh Ra be we eh ae hee quicker'sort 
rand 6 6 ww ww ww we ew we ww ww ww we we ee ee © 6d random number generator 
random ee ee ee © ~~ «Cbetter random number generator; routines for changing generators 
rmd «1 ww ee ww we ew ee ee © droutines for returning a stream to a remote command 
regex Ce ee ee ww ew eww we ee ee we ee ~~) 6reguilar expression handler 
TESOIVEr ce or es See ay HW A eS ee ee woe wo ~TESOlVEr foutines 
rexec ee ew we ew ee ee ee ww we ee ee ~~ 6return Stream to a remote command 
scandir  . 6 6 ww ee ee ww ee ee ew ww ew ee ee ew ee ee © SCAN a directory 
scanf wg ww ee ee ww eee ee we ew ee ww we ee © 6 formatted input conversion 


setbuf ee ee ew ew ee ee we we we we ee ee ee © assign buffering to a stream 
setjmp st eiectal Sah oem Ak, Co iideres alee io eh See we he, ih ee Mee Sten ee od we wee “NON-local:soto 
setuid 2. 2 6 1 we ee ee ew ee ee ew ww we ee ee we ee ~~ Set USer and group ID 
siginterrupt cee ee we ee ee ew ww eee © allow signals to interrupt system calls 
signal ee ee we we ee ee ee ww ww ew ee © Simplified software signal facilities 


SIN ww www we ee ww ww we we we ew ew ee ~~ ©6trigonometric functions and their inverses 
sinh ww ww we ee eee ee wee ee ee ww ww ew ee ee © 6dyperbolic functions 
Sleep 6 6 ww we ee ee ee we we we we ww we we ee ee © dSUSpend eXecution for interval 
SQit. 8: & Soe See we re a oe Se He a wes oS Cuberoot:square' root 
stdio ee ee eee wee we we we ee ee © Standard buffered input/output package 
SUING eo ey cette hal a Bol te ae Se th ln ee es BOE el 58 OLS Cl SSA aS, [SttINg operations 
stty ee ee wee we we ee we we ee ee © 6Set and get terminal state (defunct) 
swab a ite Tae Go aye sad ays om Spe Gar me Pk, oe ea es BL ae ee See Be? 2 Sse. , *SWap: bytes 
syslog 6 ww ew ee ee ee ee we ww ew ee ee ee ee ee © 6COntrol System log 
system ee le 8 eee el So WE be a Se Gea a eh Wes od) Ve Se e's Os, - SSUe-a'Shell: command 
termcap «ww we ww we ew ee ww we ee ee ~~ ©terminal independent operation routines 


time Sols Seaton cen tate Ub ee Se GA Ge ee a, a BE es ay oe a ete Le et dateand time: 
HIMES? Sis ate al eos, Sth eh we ae ale eee as cei eg es te wee, Ge Us wo BEL Process times 
ttyname ates Se EM al Se aw a SP OS oh A a we ei a ee “find namevofa terminal 
ualarm ee ee we ww ew ee ww we ww ww we ee © 6SChedule signal after specified time 
ungetc ce ee ee ee ww we ew we ew ee ee © 6push character back into input stream 
usleep Ce ee ee wee ee eee ww ew ee ee © 6SUSpend execution for interval 
utime ays BIRD phase. La SRA ae eeed ys: oh BRU es Sa Ogee we) Beet eh AA GS, isetiile times 
valloc ew wee ee we ww ee ew ee ee ~~ aligned memory allocator 
varargs bode eR RS ale EO Seca Soe Soe SG ac. @ §©6Varlable-argument hst 
vlimit ce ee ee ew we we ee we ee © dCONtFO] MaximuM system resource consumption 
vtimes See eee ee ew ee ee ew ee ee © 6get information about resource utilization 
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intro Cee ee ee ee ee eee wee ee ~~ 6introduction to FORTRAN library functions 
abort Ce ee ee eee ew we we ww ww ee ee © abnormal termination 
ACCESS ww we ee ee ew ee ee wwe ew ee ee © «determine accessability of a file 
alarm ww ww ee ee ww we ew we ww ee ee ~~) 6eXECUtE a SUbrOUtiNe after a specified time 
bessel ce ew we ee ee we ew ww ew we ee © dOf two Kinds for integer orders 
bit cee ee ee ew ee ee ee ew ee ee ~~ and, or, xor, not, rshift, shift bitwise functions 
chdir ce ee ee ee we ee we we www ee ee we we ee ee ee © d6Change default directory 
chmod Padi? ela wl! eg AS lw Se a Se ae es. Gs Sr Sehangemodeof afile 
etime =. 6. 6 ww we ee ee we ww we ee ww we eh ee ~~ ©eturn elapsed execution time 
exit 6 ww ee ew we ee ee ew ee ee ww we ee © 6terminate process with status 


fdate ce ee ew ee ww we we we ww ee ee ~~ ©return date and time in an ASCII string 
filmin a te Lad va ee hl wy A eh as Gr Le Get SI ok asl Je a Se en ST extreme values 
flush ce ee ee ee ee we ww ee ee ee we ew ee ~~ flush output to a logical unit 


fork 6 6 ww ee ee ee ee ee we we we ee we ew ew ee © Create a copy Of this process 
fseeck 2. 6 6 ee ee ee ee ee eee eee we ee ee ~~ eposition a file on a logical unit 
getarg ce ee ee ee we ew we we ww ee ee ee ~~ ©return command line arguments 
get ww we ee ee we ee ee we ee ee ee wh ee ©) oget acharacter from a logical unit 
getcwd ee ee ee ee ee we ew ew ee © 6get pathname of current working directory 
getenv Se ee ee ee ee ee ee we ew ee ~~ get value of environment variables 
BetlOe a's xd ar te es ear We ces ee eS ee a ee as, EL USEr’s login name 
BOT PIs.” 6 iss Ga. Ware: oS. ee Sos ase eR Da et aa Goss el GRE ae Wh es we Pe Gd. Gees we, - EL process.d 
getuid Ce ee ee ee we ee ee ee ee ew ee ee ~~) get user or group ID of the caller 
hostnm Ce ee ee ww ee ee ee ee ee ee ew ee ©) 6oget name of current host 
idate ce ee ee ee ww we we ww we ee ~~ «return date or time in numerical form 
Index 6 ww we ee ew ee ee ew ww ww ee ew we ew ee ~~ tell about character objects 


ioinit ce ee ee ee ee we ww ee ee ee we ee ee © dUChange £77 ‘I/O initialization 
kill Sey 8S we SR 8 we Bla oe we aS whereas @ ies) JSend-asignal toca process 
link ew ww ee ee ee ew ww ew ee ee ©) 6hmake a link to an existing file 
loc Ce ee ee we ewe eee we ew ee ~~ «eturn the address of an object 


long ce we ew ee ee we ww ww ee ee we ee ee ee © oInteger Object conversion 
malloc Sar Sal ae. fal Go Sa eae Baw Ae, SE asa Ce wie Sow a eae amemory allocator 
perros ww ww ee ee we ee ee we we we ww we ee we we ©) 6get System Error Messages 
plot ee ee eee wee we we ee we ~~ «£77 library interface to plot (3X) libraries. 
putc ce ee ee ee ee we we ww ww ee ee ©) 6rite a character to a fortran logical unit 
GSO ka hnd- os We ee A eh ein Se Ae NR eA es ws, CQUIck' sort 
rand Ce ee ee ew we ew ee ee we ee ee ~~ ©Feturn random values 
random =. ww ww we ee we ww ew ee ww we we ee ee ~~ Cdbetter random number generator 
TEMAME® cs. tg oe Se ee a Ao Wo A ee, BS Boke ws: ce Se Sve. “ename:acfile 
signal 2 ww we ww ww ee ee ww ee we ew we ee © dUChange the action for a signal 


sleep ee ee we we we ee ww we ww ww we ee © «Suspend execution for an interval 
stat bY wire viet er tee aanGy oe as ey eo ey ot Oa el ee We 2 Scok a 3a aoa cee SBethile status 
system Ce ee eee we ee we we ee ee ee we we ew ee) 6eXECUtE A UNIX command 
time fen ote Se oS A et Sts aoe Ge A ee Tet System:-timie 


fOPEM:. se BO. We ae eee! Bo we teh li ea ak ae a a ale ae ETT tape TO 
traper ee OEE ae a ee we Bua al eo ee wy Se 3 ea wee ~~ Sap arithmetic‘errors 
trapov ce ee ee ew we we ee ww ew ee ee ~ ©trap and repair floating point overflow 


trpfpe ce ew we we ee we we ww ew ee ee ~~ €ctrap and repair floating point faults 
ttynam ww eee ee ee ee ee we we we ee ee ee ee ~ find name of a terminal port 
unlink segs Bra ao Sl Bina OW Rae eR Be a we Wo er em er ~ TEMOVE:d. directory. entry 


wait Ce ee ee ee ew we we ew wee we ww we ee )~)©6Wait for a process to terminate 


4. Special Files 


intro cee ee we ew ww ee we we ee ~~ «introduction to special files and hardware support 
acc we ee we we ww ww ww ee ee ee ©)» «© ACC LH/DH IMP interface 
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AG: 28. Bh holes seed: a MR Sandee HS oh is ed Seis. oe ae Data Translation A/D converter 
AEP.) - 25 Sey tes hn cn aiata ee ok ee Bis a oe EE Way a a oe OS week Le a a Address Resolution Protocol 
autocont” fe.0 ee ee a RO a Se ae Soe ee diagnostics from the autoconfiguration code 
IDK: 25 ols Ses, car ila Sv. carr Selewtes aie fe. ose Hereare ws 8 line discipline for machine-machine communication (obsolete) 
CONS) Xo tena ee ESS ise mo PLA es BE Be, WE Be oe te ree eet VAX-11 console interface 
CEM? sheets og el eh lk ap Met SP Meas Sa Ae et ee EE ee VAX 8600 console RLO2 interface 
CSS a ys ey eh Bene we a eve? Boas ne Be DEC IMP-11A LH/DH IMP interface 
CUS ee leh es nie core ten dee See pends ies Seep en ie git etes yee ie he es Sete phototypesetter interface 
dn 86 Be ak Se we Ae Oe wee ey ets DDN Standard Mode X.25 IMP interface 
ade bh Ste eth oa ey te Bh Se el Br ee eh ee DEC DEUNA 10 Mb/s Ethernet interface 
Ci a Sece See ees a eo a es as See DH-11/DM-11 communications multiplexer 
GU oa ue, isin teh eaten Oe. oie Meagan, Geurnen, Se Saeed oy veo ade te DHU-11 communications multiplexer 
CIN - hoe oA eee a Ae ee DEC DMC-11/DMR-11 point-to-point communications device 
IME oso ences a Ae ae ne the hl es ES, a x a G DMF-32, terminal multiplexor 
GIN: wrt Bie ae es Oy Os ora D Wy tie oP Be rs Se ee DMZ-32 terminal multiplexor 
US = Sete So aM ak pane ee ie Tote lat ook Oa Sesh co OO dese Se Aes DN-11 autocall unit interface 
CEU 88, od ab eit che eis. aed See Bis Sp et Rete at odie Bg EON Boe A paging device 
CZs ahr ce A aa eek ele ig eee as ee he ee ly Sa he a Ee ah DZ-11 communications multiplexer 
CO” ale Sh re we, ee ey et es ay a ee ey 3Com 10 Mb/s Ethernet interface 
TIS © Sete ee ce We tot esate Oiny Kae Poa tay So Mia Soh Sue Acs Aine @ 0ea3 Gh, les Som oot Sart Xerox 3 Mb/s Ethernet interface 
CX ahs trap ts a oN sae tie Ny OY cae hk ey Ca ees ieee es ee Excelan 10 Mb/s Ethernet interface 
Bhs AS pate ae OS sage Be ae ee ray AO) G8 eR 8 see ie ak om nae a EA aa ge a console floppy interface 
dhe: inde eciire ewes er eS. dda 4 eh Sr are Be ar wh ACC IF-11/HDH IMP interface 
FS ian as ss anne ies Oak Sie ort Siu ot Ost Sie a tee See RK6-11/RK06 and RKO7 moving head disk 
Ap: 2 tots he Beas Ads. a a Ne ee a es ey Bike ee Nes MASSBUS disk interface 
Ai) enh ae a eh ee Re ates Gee ees TM-03/TE-16,TU-45,TU-77 MASSBUS magtape interface 
DY?  * vay ee Oe Re Wo es ew ee Oe ee Network Systems Hyperchannel interface 
ACIP: * sents ater ieecigs son Te oleh teeta et Aa enh an Oy HE Mads via ah tate e, vs Internet Control Message Protocol 
VOD wee Vee a) BAe ay AP cg eee BOD EE hm 8 ee ee Fee 8 Xerox Internet Datagram Protocol 
UK S56 eh a aes eh eats Ais, eh vleettan i A wal eb Metaas <a? so ee Ikonas frame buffer, graphics device interface 
Ut ep Were Bee SR Se Ser ee ea Interlan NI1010 10 Mb/s Ethernet interface 
TIPS, Ae ae Sena ee to Meh eh he Teele ah deed Jon, Sate, Ses US. Sens ete as Se 1822 network interface 
TMP? Bice ch esd ty Eek ee ky Get id, eth oh Sie ein. “an Re See Hoge S IMP raw socket interface 
INGE: sal ied Puss da hie "a, ee ae ee Be a de A Eee ae Ee te Sate Internet protocol family 
IP) erie says ae te ar eras Bas WY ee AE we ON Rar, et er Bec ee Internet Protocol 
KE eerie Te Sa Sale Wiel SCS cen ae VES, $3 nse) ep Interlan Np100 10 Mb/s Ethernet interface 
Key, othe ah iat wes Shh Gk Gp ven Gh tia eDiets att a ae oP rh ta ot adel 35 Gee et KL-11/DL-11W line clock 
VO og, soot Sy Ne ec, Bip Wee Aw ee gi Rg a ee software loopback network interface 
[pis ~ says are 31 oh hates!) bd, Seneca sb ot Sencar shy alin May WOR aitehe, Seda! tee line printer 
TNGTN als abe cae “sip ahaa too WS cae Sepang MSs AS en oer We Gad Selves Be Ad “Gah Be Ne es AS, dee main memory 
MNES - Sai tac tieves es S6¥. 28); <oSs ss, Sg 8s oy 008 sat ses Sas 1O8 TM78/TU-78 MASSBUS magtape interface 
TINUIQ? Sartre sols! foie Sages ph te xd pat at ds oS God ak aa ee dost aed ainda res, vines UNIX magtape interface 
TU «an 33 ed pea estoy sd, MOT ABE Se ae kc Sy GE Ta ade Des Interlan Np100 10 Mb/s Ethernet interface 
MS 5 fee By Se Gone Ae ee By a a Xerox Network Systems(tm) protocol family 
DSIP: © Cai reGo Gees 28: ta ey Soi vee software network interface encapsulating ns packets in ip packets. 
MULL! © 24. oi dee say Be si ey ee? iat: MEAD ees eB a eles ee ae a ee) re es data sink 
PCE? eh tiTshd Mle Se SAE So 8S ed Se BS ects ee, ab eS DEC CSS PCL-11 B Network Interface 
PS’. ata ae BESO SSR Evans and Sutherland Picture System 2 graphics device interface 
DEY,” Sead vas oa8 Rs tinvey eh Sal Pa pties Gee 18 JS ae es er 6" A ak FOS tees aS SS et pseudo terminal driver 
(0 (= a a a ee me ae eee DEC DEQNA Q-bus 10 Mb/s Ethernet interface 
EX. Lye cats. W) as ebay tei Hse ole, Sa em, tart, oh ogy ae oa) oon de 2 DEC RX02 floppy disk interface 
SPDs oat aelk @ a Se eae sas Vee BP BR. ESS Xerox Sequenced Packet Protocol 
CDs. “ets 5S sah ree) Sa ai“ be meme 4 8k ae we Reet ae wen ale ee ne line discipline for digitizing devices 
TEP ids iP a pa hake ee aed ee a eae Se eS Internet Transmission Control Protocol 
CO, aide ne nay 26.535, 8 Sb a hy hs fae at TS geass xh, See TM-11/TE-10 magtape interface 
TMSCP?. eel ade ee i ee Me ey ual a eRe a oye Se DEC TMSCP magtape interface 
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TS-11 magtape interface 
tty ce ee ee ew ee ee ew ww we ew we ee ~~ 6general terminal interface 
VAX-11/730 and VAX-11/750 TUS58 console cassette interface 
uda ee ee ee ee ww ww ew ew ee ee © )©6 UDA-50 disk controller interface 
udp ce ee ew ww ew we we we ww ww we ee © «Cdnternet User Datagram Protocol 
UP 6 ww we ee ee ew ww we we ew ew ee ee © dcunibus Storage module controller/drives 
ut ee ee ee ew ee we ew ww ee  e)©6hUUNIBUS TUS4S tri-density tape drive interface 
TU58/DECtape IT UNIBUS cassette interface 
va we ee ww ee we we we ee ww we ww we ee ee ©) dBenson-Varian interface 
vp eS Sa ge RL ey ol Se Blas Soe Se A Re ae ee a he Sr tweet As Mersatecantertace 
vv ce ew we ee ew ww ew ww ww ee ee ~~ © ~Proteon proNET 10 Megabit ring 


ts a 


tu i 


uu a 


5. File Formats 


4.3BSD 


L-devices ce ee ew ew we we we ww ww ew we ee © © ~©UUCP device description file 
L-dialcodes we eee ww ww we we we ww we ee © © «© UUCP phone number index file 
Lialiases 6 6 ww ee ew ee ee ee ew ww we we ee ee © © UUCP hostname alias file 
L.cmds wee ee ee ee ww we ew we ee © © )©© UUCP remote command permissions file 
LisyS 6 wwe ee we ee ew ww ww we we ee ~~ © © UUCP remote host description file 
USERFILE . 2... 1 1 1 1 eee ee ee ew ew ee ee © ~©UUCP pathname permissions file 
assembler and link editor output 
acct Ce we ew ee ew we we we ee wee ee ww ee ee ee) 6eXECUtION accounting file 
aliases ww we ww ee ee ee we ee ee ee ww ee ee ~~ aliases file for sendmail 
archive (library) file format 
core cee ee ew ee ee we ww we ee ee ew ee ee ©) 6format of memory image file 
dbx ce ee ee we we ew ww ww ee ee ee © dX symbol table information 
. .. . .. ~~ format of directories 
disktab bd Spiraea, tees Bee AP a, eS A oe be es a Se oe ater. “dask-description:file 


QsOUL) ve wilt eA ae Sea ei a ee) ist WSS eed eS VL eo 


dump Ce ee ee ee ee ee ew ew ee ee ew ew ee ~~ 6incremental dump format 
fs Ce ee ee we eee we we we ee ee © format Of file system volume 
fstab cee ew ee ee ee we ew ww we ee ~~ Static information about the filesystems 


gettytab 6 ww ww ee ee ee ee ee ew ee we ee ~~ €cterminal configuration data base 


OTOUP.. See ee Soe. Siete. Be wilt a Sy Ste SL oete. SA, es ie Reo we Ye eee oe 2 Broup file 
HOSts? ds 200-75, sac eh ee sgt Sores he a? a We 8 . . . . . hostname data base 


map3270 . ....... ++... database for mapping ascii keystrokes into IBM 3270 keys 


mtab cee ww ew wee we we ww ww ee ee we we ee eh ©)©6mounted file system table 
networks ew we ee ee eee ew ww we ee we ee ©) onetwork name data base 
passwd inh Bee Se Se ee ek a, 8 ER eh i Ee ee OR Re ee Bae Ss. «Password file 
phones cee ee ee ew ew ww we we we ww ee ee © 6dremote host phone number data base 
plot Stal vee Oh ec ee SA Ne dee ewe ee Geet oe i Oe eye ie ead Meet Ake, apraphicsntertace 
printcap 6 ww we ee ee ew ee ee ee ww we ee ee ~~ «Cprinter capability data base 
protocols ce ee ee ew we ww we ww we ww ee ee ~~ ©@protocol name data base 
remote ee ee we ee we we ew ww we we ww ew ee © 6remote host description file 
resolver we ee ee we ww we we ee ee ew ee ~~ «resolver configuration file 
services ce ew we ew ew ew we we ew ww we we ww we ee ~~ 6SEFVICe NAME data base 
stab 6 ww ee we ee ee ee we wee wee ww we ee ee ee ~~) 6SYMbO! table types 
tar be SO Sey Ba ew a eS we Re oe Reece 4S « «6 Staperarchive file format 
termcap we we ee ee ee ew we ee ee ~~ «terminal capability data base 


TP ee Ow eee eee Se es oe» §6“DEC/mag tape formats 
ttYS 6 we ee ee ee ew ww ee ew ew ee ee ~~ 6cterminal initialization data 
types 6 ww ww ee ee ee we we we ee ee we we ee ee ~~ primitive system data types 
utmp soy ibele a ot Gee Se ah GY Je Seah aes ie Se a ee ea ek, oe ey aoe? oginirecords 
uuencode ..... 2... ee ee ee ee ew ee ee © 6format of an encoded uuencode file 
vfont .......... ++. e+... font formats for the Benson-Varian or Versatec 
verindefs  . 1 ww ww ww ee ee we ee we we eh © dUVgrind’s language definition data base 
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6. Games 


aardvark 6 ww ww ee ee eww we ee ww ww we we ee © 6©et another exploration game 
adventure 2. 6 ww ee ww we eee ew ww we we we ww ew ee ee ©6oan exploration game 
arithmetic ee eee ee we we we ww we ee ee © d@provide drill in number facts 
backgammon: ~ ces ok vei ce a eed oat alte Se at OP oe, oe SE a ohn Sw: Legs AD ce es. the Bame 
banner ww ww ww wee ee we ee ew ww ee ee ee ~~ «©print Jarge banner on printer 
battlestar 6 ww ww ee ee ww ee ee ee ee ee ee © atropical adventure game 


bed Ce ee ee ew we ew ww ee ee we ew ee ew ee © 6CONVETt tO aNtique media 
boggle Bal 8) eae Bh See le ES ah goes A et Bs ee ew Splay theeame-of bogsle 
canfield ce ee ee ee ee ee we ww we ee ee ~~ «the solitaire card game canfield 
chess ob, eid: Ge ald, UOT oe Oe eo) EAN eee jo ot ari eas Go ar ee. the:fame-of.chess 
ching we ee ee ew ew ww we we ww we ee ~~ «the BOOK Of Changes and other cookies 
cribbage ok 8? Pace es Bae cao Feeds Sao oR ee Se ae a ee es a the Card:game:cnbbage 


doctor 2. 6 6 wwe ee we eee ee ww we ee we ee ~~ ointeract With a psychoanalyst 
TSI) ey es Sy yo SD oR ee Bo Ga ae re, sa a8 So es Be eee ew ro fplayeGo-Fish:’ 
fortune ee ee we ee ee ew ww we ee ~~ 6Oprint a random, hopefully interesting, adage 
hangman ce ee ee ee ww we we we ww ee ee © Computer version of the game hangman 
hunt 6 ww ww ee ee we ee ee ww we ee ee ©) doa multi-player multi-terminal game 
mille sR HOES Sk, ARB ew Glee se ar Pe a ee wl a eo See BIS oe ~play.Mille:Bournes 


monop bie Sw wa sale see Sal Bo el aw eee ee 4 3 ~Monopoly:same 
number ce ee ee we ee we ee we ww ee ee © 6COnvert Arabic numerals to English 
quiz So wy Sac tae ek we Gas Gel Wah BS. Gey Wl wr Gorda, Wl eels oP at ws eS ewe oe et e.  -etest-your- knowledge 
rain cee ee ew ee ee ew ew ww ee ee we ee ee ©) animated raindrops display 
robots ee ee ee ee ee we ew ee ee ee ee ~~ fight off villainous robots 


TOgSUG 6 6 ww we we ww ww we ew ww we ee ee ~h6©)d«UEXploring The Dungeons of Doom 
sail we ee ww ee ee ee we ww we ee ee ~~ «multi-user wooden ships and iron men 
SNAKE: . ss eee Sees aj ye ei be aye ek Sa ie tae OE Gira, teres AO 8 ae ay - dSplay-chase- same 
trek set Gor a, ae AD NS eh cect ease aay Mec at PGR a Ae ete os Owe wye ecerads ace ee “rekkie:same 
Worm ww we ee we wee we ee we ww ee ee ee eh he ©) d~P lay the growing Worm game 
worms ce ee we ee ee ee we we ww we ee ee © animate Worms on a display terminal 
wump Ce ee we ee ee we we ew ww we we we ~~ «6the game of hunt-the-wumpus 
ZOVK wwe ew ee ee eh we we we ew we ee ee ee ww ee ~~ «the game of dungeon 


7. Miscellaneous 


intro cee ee ee we ee we ww ww we ee ee ~~©6©miScellaneous useful information pages 
ascii SSS ae RSE 8k Res RS ea we SS ewe eee ao a ~mMaprof ASCIlcharacterset 
eENVION ww ww we ee ee we we we ew ew we ee ww we we ee ee ~) UUSUF ENVIFONMENT 


eqnchar ee ee we ee ee ee ee ww ww ee ee © Special character definitions for eqn 
Mier 6 ww ww ee ee ee ee ee ee we ee ee ee we ee ~~ file system hierarchy 
mailaddr Ce ew we ee we ww ew ww we ee ee ©) 6hmail addressing description 


mang ww we ee ew ee ee ww we ww we ew ww ee ee ~©6©macros to typeset manual 
me ee ee ee we ewe wee wee ee ~~ ©~©6omacros for formatting papers 
ms cw ee ee ee ee ew we ee we we ww we ew ~~ 6text formatting macros 
term ww we ee ee ee ee ee we ew we ee ee © 6CONVENtIONAl Names for terminals 


8. System Maintenance 


intro ce ee ee ee ee ee ~~ 6introduction to system maintenance and operation commands 
XNSrouted ee ew ee we ew ww ew ee ee ©)6NS Routing Information Protocol daemon 
ac Oa SRS Be ee iy werk ee Gee Sake eee" Soar en Goer a ore ke login accounting 
adduser ce ee we we we we we we ww ew ew ee ee © ©@procedure for adding new users 
arff ce ew ee ew ee ew ww ww we ee ee ~~ archiver and copier for floppy 
arp cee ee ew ew we we we we ww ee ee © address resolution display and control 
bad144 ce ee we ee ew ww ee ee ~~ ©read/write dec standard 144 bad sector information 
badsect ce ee ee ee we ww ew we ww ee ee © Create files to contain bad sectors 


bugfiler 2... 1... 2 ee ee we ee ee ew ~~ file bug reports in folders automatically 
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catman «ww ww ew ee we we we we we ww we ww ee ~~ «Create the cat files for the manual 
chown ge ea tl ote ek ye li eg Re Rae SMe Be ee eR ae ee fe ee 4? Chan gecowner 
CIE) Goss ar ns Be ene SS a OS dcr GE) Se a ad ey eed ee: eke MCléarscnode 
Comsat. © !a oe. Soe, Se Be NS Se Manes aS We ee Ae te ae ae ee, Ebieserver 
config 6. 6. 6 6 ww ee ee ee ww we we ew ww ee ee ~~ dUiLd System configuration files 


crash ce ee ee ee ww ww ww ww we ee © © ~~ ~©)©6©What happens when the system crashes 
cron Be Dates eo ae APE OG Oa Se Oe Raw woe ae SS woe TElOCK daemon 
dcheck cee ew ee ew we ee ee ew ee ee ~~ file System directory consistency check 
diskpart Ce we eee ee ee ww ww ee ee © Calculate default disk partition sizes 
dmesg cee ee ee we ww we ew ew © Collect system diagnostic messages to form error log 
drtest ee ee we ee ee ewe ww ww we ew we ee ~~ Standalone disk test program 


dump .. 2... 2. ee ee ew we we ee ee we ee ee © 6ciNcremental file system dump 
dumpfs ce ee ee ee ee ee ee we we ee ee ©) 6dump file system information 
edquota Be Ria Sa Gat a eae ge RE ee eS Beet Qa ee we abs ea eer - edit user: quotas 
fastboot .. 1... 1 ee ee ww ee ee © ©reboot/halt the system without checking the disks 
fingerd 2. 2 1 1 1 we ee we ew we ee ee ew ew ee ee © dremote USer information server 
format ee ee ee we ww ww we ew ww ee ee ~~ ~©6©how to format disk packs 
fsck 2. 2. 1 1 ee ee ee we ew ee ~~ file System consistency check and interactive repair 
ftlpd 2... 1 1 ww we ee ew ee ee ee © DARPA Internet File Transfer Protocol server 
gettable ce ee ee ew ee ww we ew ew ee © get NIC format host tables from a host 
getty 2 ee ee ee ee ee ee we ee ee we we ww ee ew ee ~~) SUL terminal mode 


halt BRE Ss Pie 8 sai ey ee telah la,” Sy Meee al 8S eS eH Pe hie a Aa Ss. Stop theprocessor 
htable ce ee ee ee ww ee we we we ww ee ee © 6COnvert NIC standard format host tables 
icheck ce ee ee we we we we we ew we ew ee ~~ file System storage consistency check 
ifconfig ee ee ee ee ee we ew ww ee ee © 6COnfigure network interface parameters 
implog se Be we We Rae a oe Se ee Bo i, ek Sa a ae Se a AIM Jog interpreter 


implogd .. 1. 1 1 ee ee ee ee we we ee ew we we ee ee )hUIMP logger process 
inetd Sw ee, Rete Wi Ae et ey oe oe ee ew aS, ~“antemmeto*super—sérver*’ 
init ce ee ew we we ee ww we ee ww ew ee ~~ 6process control initialization 
kgmon se ee ew we we ww ew we ee © generate a dump of the operating system’s profile buffers 
Ipc cee ee ee ee we we we eee ew we ee ee ~~ «dine printer control program 
Ipd ww we ew we we eee ew ww ee ee ee ew ee eee ~~ «ddine printer daemon 
makedev ce ee ee ew ee we we ww eee ww we ee ee ©)©6make system special files 
makekey . 2... 1 eee we we ee ee we we ee ee ee we ee) 6generate encryption key 
mkfs 6 www ee ew ee eee ee wwe ee ee ee ew ee ee © 6COnStrUCt A file System 
mkhosts ce ew we ww ee ww ew we ww we we ew ew ee ~~ 6generate hashed host table 
mklost+found Cee eee eee eee we ee ee  ©)6hmake a lost+found directory for fsck 
mknod Si uss tSaye nal g¥S Thy tote dy pat Misty Ua Sp ey el wes ey Welee st use aE wi aise Se Boel -er et Duuld special file 
mkpasswd wg ww ww ee ew ww ww we we ww ww we ee ~~) generate hashed password table 


mkproto ce ee we ee ee ww ww ww ee ee © 6CONStUCt a prototype file system 
mount ce ee we eee ee ew ww ww we ee ee © 6 mount and dismount file system 
named «ww ww ew ew ew ee ee ww ww we ww ee ~~ «©dInternet domain name server 
ncheck ce ee ee ee we ew we ww we ee eh © 6generate names from i-numbers 
newfs 2... eee we we ee ee we ww ee ew ee we ee © 6CONStUCt A NEW file system 
pac si Sasser ten coe ge Bie oe ah as ee - . . . printer/plotter accounting information 


ping ae Tait igs SS, sae By WEL! a Be Be mene ICMP ECHO REQUEST packets to network hosts 
PStat: © p58 tess 8h AS Gi we eal es bea Sk Re we es: ya et ay oe, Soe,» Sprnitsystem: facts 
quot 6. 6 ww ee ee ew we ee we we ww ee ee we ©) 6 SUMmMartize file System Ownership 
quotacheck eee ee we we we ee ee ww we we ee ~~ file System quota consistency checker 
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notes, 
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find the printable strings in a object, or other 
uuencode, uudecode: encode/decode a 
fread, fwrite: buffered 

bind: 


4.3BSD 


- XXVii - 
atagivenitimes: . Goede Bice he SI ee ee shutdown(8) 
atalatertimes 655s: So as ae eer Ae cae ar ee ae at(1) 
at: execute commands atalatertime. .........6-. at(1) 
at low priority (shonly), 2... 2... eee ee ee eee nice(1) 
atan, atan2: trigonometric functions andtheir ........ sin(3M) 
atan?2: trigonometric functions and their inverses. . .... . sin(3M) 
atanh: inverse hyperbolic functions. .........4.. asinh(3M) 
atof, atoi, atol: convert ASCII tonumbers. . ........ atof(3) 
atoi, atol: convert ASCII tonumbers. . ........22- atof(3) 
atol: convert ASCII tonumbers. . . 2... 2... 2 ee ee atof(3) 
atomically release blocked signals and waitfor ....... sigpause(2) 
atq: print the queue of jobs waiting toberun. . ....... atq(1) 
atrm: remove jobs spooled by at. ........2.+.2.-. atrm(1) 
attach serial lines as network interfaces. . .... 2... slattach(8C) 
autocall unit interface. . . 6... 1 ee ew ee ee ee dn(4) 
autoconf: diagnostics from the autoconfiguration ...... autoconf(4) 
autoconfigurationcode. . ..... +... e eee eee autoconf(4) 
automatically: 00-3 pose tec 8 Oe ee on ee Sew ane Go a a bugfiler(8) 
auto-reboot and daemons. ........2.4-++428e80- re(8) 
autoseq, readnotes: anews system. . .. 2... eee ee notes(1) 
await completion of process. . . 2... 2. ee eee eee wait(1) 
awk: pattern scanning and processing language. . ...... awk(1) 
backgammon: the game. . 2... 2 ee ee ee eee backgammon(6) 
backerounds 2 i6: sean x ee era Ge a de ee ae OP Gee a esh(1) 
background processes tocomplete. . .......-42.6. csh(1) 
bad sectorinformation, . .... 2... ee eee eee bad144(8) 
Dad SeCtors.* + wet ese ek Gots eal ch eae hee ae GS badsect(8) 
bad144: read/write dec standard 144 bad sector ....... bad144(8) 
badsect: create files to contain bad sectors. . .... 2... badsect(8) 
banner onprinter. . .. 1... eee ee ee ee ee banner(6) 
banner: print large banner on printer. . .... 2... eee banner(6) 
DaSGs, Srey Meese Se ces ta Se hs SM i eet eee a gettytab(5) 
DaSES.  xSzrsi ey cocdn peeist tate Wey Sens SS cee St ah “Vepte suds Sater Tet ee ests hosts(5) 
bases”. Sites sas Sob ee a we Ses aes Gee See ee ee Sara Se networks(5) 
Dass. 6 26.2 Mite e Sts huey eo eh eo tel eke aS Salts Lay BOA phones(5) 
aS? sete ee caries teote ysl ee casas tae WSs a ey Sestied th SI" RE, See casi printcap(5) 
base” . ey tao ae pe: wae Ee cee ah et ae Ee Sa OSS AD He ee ce protocols(5) 
bases. oes es ee en ae ees ee Sue eae services(5) 
base: Sas Gray ta hbo a, ds ty ale olen ra oom Ae termcap(5) 
DaSe 2 20 cde. 2s AG) ot one ee Sao cee Sates sane che ge tah BENS amy cane Poe vgrindefs(5) 
base for the mail aliases file. . ........4.6.2.26- newaliases(1) 
base subroutines. dbminit, ...........-428-6. dbm(3X) 
base subroutines. /dbm_delete,dbm_firstkey, ....... ndbm(3) 
DaSOdONORy » seo Se ce Avs, cet a, oF GRE ce Se Uae oS, PRO ey ies NS teh 2 vi(1) 
basename: strip filename affixes. .........2.2.6. basename(1) 
battlestar: a tropical adventure game. . ... 2... 2 eee battlestar(6) 
be: arbitrary-precision arithmetic language. ........ be(1) 
bcd: convert to antiquemedia. ..........4.2... bced(6) 
bemp, bzero, ffs: bit and byte string operations. . ...... bstring(3) 
bcopy, bemp, bzero, ffs: bit and byte string ........ bstring(3) 
IDeaUtifiers 22. ost 1s Se-ete'aPe iathe, Sate G> Siete. oat He cb(1) 
Benson-Varian interface. . . . . 1. 6 ee ee ee we va(4) 
Benson-Varian or Versatec. . . 2... 2 ee eee eee vfont(5) 
bessel functions. . 2... 6. 1 ee ee ee ee ee j0(3M) 
bessel functions: of two kinds for integer orders. ...... bessel(3F) 
better random number generator. .........42+2- random(3F) 
better random number generator; routines for ........ random(3) 
bg: place job in background. .........46.2-+2-0. csh(1) 
bib, listrefs: bibliographic formatter; list... .....4.. bib(1) 
bibliographic database. . . 1... 2... 2 eee ee ee addbib(1) 
bibliographic database. . . 1... 1. ee ee ee ee roffbib(1) 
bibliographic database. .. 1... 2... 2 eee ee ee sortbib(1) 
bibliographic formatter; list bibliographic ......... bib(1) 
bibliographic reference items. . ........-+2-2- bib(1) 
bibliography. indxbib, lookbib: buildinverted ....... lookbib(1) 
bibliography, find references ina bibliography. ....... lookbib(1) 
biff: be notified if mail arrives and whoitis ........ biff(1) 
biff Servers’ fers Ae. ek od bes ew wel oe fe ceed da comsat(8C) 
IDINATIES2 pcs" Shae BS heey te Tet ae a i ee ee Sah Lt at ee tee wee ae LD install(1) 
binary, and or manual for program. . .......-.-2 ee whereis(1) 
binary; filé.. Strings?) 030.6 6s gee Se ew Se as strings(1) 
binary file for transmission viamail. ..........-. uuencode(1C) 
binary input/output. 2. 6 6. ee ee ee ee fread(3S) 
bindanametoasocket. . ... 2... 2 2 eee eee bind(2) 
bind: bind a name toasocket. . .... 2... eee eee bind(2) 
binmail: send or receive mail among users. ........ binmail(1) 
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bcopy, bemp, bzero, ffs: 

functions. 

bit: and, or, xor, not, rshift, Ishift 
communication (obsolete). 

sync: update the super 

update: periodically update the super 
sigblock: 

sigpause: atomically release 

sum: sum and count 

boggle: play the game of 


ching: the 

reboot: UNIX 

mille: play Mille 

switch: multi-way command 

login,/ sh, for, case, if, while, :, ., 


fg: 


ik: Ikonas frame 

fread, fwrite: 

stdio: standard 

setbuf, setbuffer, setlinebuf: assign 

generate a dump of the operating system’s profile 
sendbug: mail a system 

bugfiler: file 

automatically. 

references in a bibliography. indxbib, lookbib: 
mknod: 

config: 

ntohs: convert values between host and network 
bcopy, bemp, bzero, ffs: bit and 

swab: swap 

bcopy, bemp, 

ce: 

intro: introduction to 

cb: 

indent: indent and format 

lint: a 

xstr: extract strings from 

mkstr: create an error message file by massaging 
hypot, 


diskpart: 
de: desk 
cal: print 


syscall: indirect system 

gprof: display 

getuid, getgid: get user or group ID of the 
malloc, free, realloc, 

siginterrupt: allow signals to interrupt system 
intro: introduction to system 

canfield, cfscores: the solitaire card game 
canfield. 

printcap: printer 

termcap: terminal 

canfield, cfscores: the solitaire 

cribbage: the 

cd, eval, exec, exit, export, login,/ sh, for, 


tu: VAX-11/730 and VAX-11/750 TU58 console 
uu: TU5S8/DECtape II UNIBUS 


catman: create the 


default: 
cat: 


case, if, while, :, . , break, continue, 
round-to-nearest functions. fabs, floor, 
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bit and byte string operations. . 2... 2. 1 ee ee eee bstring(3) 
bit: and, or, xor, not, rshift, shift bitwise .......4.. bit(3F) 
bitwise functions. ... 1... eee ee ew ee ee we bit(@F) 
bk: line discipline for machine-machine .......... bk(4) 
DIGCK >. «ax Sepsis pa) Sat Aw te ee iG bathe Vet TE, > as Ln Soha ees sync(8) 
DIOCK 4, 25+ de 25 Ab) Belts sb te ahs wo Se he Pe Let es ied update(8) 
block:signals., fos. Se ee oe Sw te we Ao sigblock(2) 
blocked signals and wait for interrupt. .......... sigpause(2) 
blocks in-afiles > 25: eee gee, ol Rb Seo at po, MER et es sum(1) 
Bosses ot a. te eG, fo te aos Gi ee ana Sure os boggle(6) 
boggle: play the game of boggle. .........2.2.2. boggle(6) 
book of changes and other cookies. ........068. ching(6) 
bootstrapping procedures. .... 2... ee eee eee reboot(8) 
IBQUENESS > js see te Beale a Re ere Se idee IS Moh tees er ee ae mille(6) 
branch... cx fe_ sds > Sah sorte: anna) ce Mietalee ha ee ayaa se Rohan esh(1) 
break, continue, cd, eval, exec, exit, export, ........ sh(1) 
break: exit while/foreach loop. .........2-+.2-. csh(1) 
breaksw: exit fromswitchh ........6006.2820008-8 csh(1) 
bring job into foreground. ..... 2... 2 ee ee ee csh(1) 
brk, sbrk: change datasegment size. .......-+.2-. brk(2) 
buffer, graphics device interface. ........2.24.- ik(4) 
buffered binary input/output. 2... 1. ee ee ee fread(3S) 
buffered input/output package. «2... ee ee ee ee stdio(3S) 
buffering toastream. .. 1... 2... eee ee ee ee setbuf(3S) 
buffers. kgmon: . 1... 1 1 ee eee ee ee ee kgmon(8) 
bug report to 4bsd-bugs. . . 2... 6. eee ee eee sendbug(1) 
bug reports in folders automatically, ........... bugfiler(8) 
bugfiler: file bug reportsinfolders ...........- bugfiler(8) 
build inverted index for a bibliography, find ........ lookbib(1) 
build-spectal files s2c60 ed. to 8 Sec ge el eS SE ee SE mknod(8) 
build system configuration files. . 2... .. 2... 2.20 config(8) 
byte order. htonl,htons,ntohl, ..........2.2.- byteorder(3N) 
byte string operations. 2... 1 we ee ee ee ee ee bstring(3) 
Byt@Se: cts, Se eS oie ee Wd Cee se ee ew swab(3) 
bzero, ffs: bit and byte string operations. ......... bstring(3) 
Grcompilers oe. cae es S462 48 Set cd eS ER GS Re Sete cc(1) 
Clibrary functions. . .. 1... 2. ee ee ee eee intro(3) 
Cprogram beautifier, . 2... 2... 2.2.2 ee ee eee cb(1) 
C program source. . 2... 2. ee ee ee ee ee eee indent(1) 
Cprogram-verifiers ac wae ee se ek lint(1) 
C programs to implement shared strings. ......... xstr(1) 
GSOUrCE: = ao fa ee eee ck a Ra Se mkstr(1) 
cabs: Euclidean distance, complex absolute value. . ..... hypot(3M) 
Calsprint-calendar:, 0.6.00: 8) ve Bee. es, ee ey cal(1) 
calculate default disk partition sizes. .........4.- diskpart(8) 
Calculator:- © 2 <eoseocear bet oe eee sd so Sen es eee ae de(1) 
Calendar. 26. ote 6g eae Le EAE cae he WSR Mee LEE 8 cal(1) 
calendar: reminder service. . . 1... 2. 1 ee ee eee calendar(1) 
CAN». S095: (oS. CRE AN, FD RA A -S,  CAS ER CE syscall(2) 
call graph profiledata) . . 2... 1. ee ee ee ee ee gprof(1) 
Caller. she Gs.4eh 62% ce nds ea ei cet wi tet AD ee utah ds erat z getuid(3F) 
calloc, alloca: memory allocator. .........+.2.2-. malloc(3) 
CAMS Sy wy Ge Smee: Uh nwos Gal Teen ve aet Jat Ao Os st ek CONAN es Geek YS siginterrupt(3) 
calls anderrornumbers. .... 2... 2 2 ee ee eee intro(2) 
Catifields occ Hy roped. aS bd, fe RS cae Be fe DO eh eA canfield(6) 
canfield, cfscores: the solitaire cardgame ......... canfield(6) 
capability database. . 2... 1 ee ee ee ee ee ee printcap(5) 
capability database. . 6. 1. 1 we ee ee ee ee ee termcap(5) 
cardgamecanfield. . . 1... 1. 2 ee ee ee ee ee canfield(6) 
cardgamecribbage. .. 2... 6. ee ee ee ee ee cribbage(6) 
case, if, while, :, .,break,continue, ........4.-. sh(1) 
case: selectorinswitch, . ... 1... ee eee eens csh(1) 
cassetteinterface. 1... 6. 2 we ee ew wee ewe tu(4) 
Cassette interace:. «wis ds ae Ay wilt Ws eee ie oe ete eae uu(4) 
cat:catenate and print. . . 1... 1. ee ee ee eee cat(1) 
cat filesforthe manual ...... 2.2.2. eee eee catman(8) 
catchall clause inswitchh . . 2... 6 2 eee ee eee csh(1) 
catenate and print ... 1... 2. ee ee ee ee ee cat(1) 
catman: create the cat files forthe manual. ......... catman(8) 
cb: C program beautifier. . 2... 1. ee ee ee ee cb(1) 
cbrt, sqrt: cube root, squareroot. . . ... 2... ee eee sqrt(3M) 
cer Cieompiler. + neni gosh se eal Ge BRE we cec(1) 
cd: change directory, . 2... 2... eee ee eee ee csh(1) 
cd: change working directory. . .... 2... 2.2. eee cd(1) 
cd, eval, exec, exit, export, login, read/ /for, ........ sh(1) 
ceil, rint: absolute value, floor, ceiling, and ........ floor(3M) 
4.3BSD 


Permuted Index 


fabs, floor, ceil, rint: absolute value, floor, 
canfield, 

chdir: 

brk, sbrk: 

chdir: 

cd: 

chdir: 

ioinit: 

chgrp: 

chmod: 

chmod: 

chmod: 

umask: 

chown: 

chown: 

chfn, chsh, passwd: 

chfn, chsh, passwd: 

chfn, chsh, passwd: 

chroot: 

signal: 

rename: 

Set: 

cd: 

ching: the book of 

better random number generator; routines for 
pipe: create an interprocess communication 
ungetc: push 

iscntrl, isascii, toupper, tolower, toascii: 
eqnchar: special 

getc, fgetc: geta 

index, rindex, InbInk, len: tell about 
getc, getchar, fgetc, getw: get 

putc, putchar, fputc, putw: put 

ascii: map of ASCII 

putc, fputc: write a 

style: analyze surface 

tr: translate 

snake, snscore: display 


dcheck: file system directory consistency 
icheck: file system storage consistency 

fsck: file system consistency 

checknr: 

eqn, neqn, 

quotacheck: file system quota consistency 
fastboot, fasthalt: reboot/halt the system without 


chess: the game of 


information. 
information. 
information. 


chfn, 

chfn, 

chfn, 

closepl:/ plot: openpl, erase, label, line, 
isascii, toupper, tolower, toascii: character 
default: catchall 

uuclean: uucp spool directory 


clri: 

clear: 

ferror, feof, 

csh: a shell (command interpreter) with 

the time to allow synchronization of the system 
kg: KL-11/DL-11W line 
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ceiling, and round-to-nearest functions. .......... floor(3M) 
cfscores: the solitaire card game canfield. . ........ canfield(6) 
change current working directory. ........-+-+.- chdir(2) 
change datasegment size. . . 2... ee ee ee ee ee brk(2) 
change default directory, . 2... 1 ee ee ee ee ee chdir(3F) 
change directory: <6. do es eee. eR Ts ew csh(1) 
change directory: 6. 6 6 6 fe we oe ewe csh(1) 
change f77 I/O initialization, 2... 2. ee ee ee ee ioinit(3F) 
change Sroup: 6. Wise Sa oe We ae Ee, Bw, chgrp(1) 
Change*Mode 2s 45. seh Sse foe's cert es S. Ses Hee eA chmod(1) 
change mode ofafile. 2... 2. ee eee ee eee ee chmod(3F) 
change mode offile. . 2... 2... 2. eee eee eee chmod(2) 
change or display file creationmask. ........... csh(1) 
cChange:Owner,.. ss. 26e- lees ee ge 2a ees lane Ae te a ella ee chown(8) 
change owner and groupofafile. ............ chown(2) 
change password file information, .........2... chfn(1) 
change password file information, ..........2.. chsh(1) 
change password file information, ............ passwd(1) 
change root directory. . . 1... 2 ee ee ee ee we chroot(2) 
change the actionforasignal . 2... 1... ee ee eee signal(3F) 
change the name ofafile. ........2..4.2420.6. rename(2) 
change value of shell variable. ..........02.6. esh(1) 
change working directory. ...... 2... eee eee cd(1) 
changes and other cookies. . .. 1... 2... eee eee ching(6) 
changing generators. /srandom, initstate, setstate: . ..... random(3) 
Channels) cob wep ae tk GP a, fa Dw, BOR SIS. S pipe(2) 
character back intoinput stream. . . .. 1... 2... eee ungetc(3S) 
character classification macros. /isprint,isgraph, ...... ctype(3) 
character definitions foreqn. .........-+2e00- eqnchar(7) 
character from alogicalunit. ..........+.2e+.- getc(3F) 
chatacter objects:- 3. seas uel ee a es Hae sae index(3F) 
character or word from stream. . . 2... 2... ee eee getc(3S) 
character or wordonastreaam. ........-+.2e+0- putc(3S) 
Character Sets < sens Sho este dacs leo ew? Bites 8 ae he ee ee as ascii(7) 
character to afortranlogicalunit. ..... 2... 220s putc(3F) 
characteristics of adocument. ..........4.+2--. style(1) 
GChardcterss: ».2. 26) ugh tay de wae tee Pate Ge i OP AG: ee tr(1) 
chasepame.. xu.3) aie os ee aes ae ee eS snake(6) 
chdir: change current working directory. ......... chdir(2) 
chdir: change default directory. .........4.+.2.. chdir(3F) 
chdir: change directory. . ......-2.-5. ee ee eee csh(1) 
CHECK ca a fey ae Ft SK fog GG Se ox ST Set dcheck(8) 
Check. 623 ao ee A hata: eee 2 aT icheck(8) 
check and interactive repair, . .... 2... eee eee fsck(8) 
check nroff/troff fil€s.. 6. 6. eee fe ee ca ee ee checknr(1) 
checkeq: typeset mathematics. ........6..+24.6. eqn(1) 
CHECK SE - ee Sy coh ek Og SS a So nek a bee as ne quotacheck(8) 
checking. the disks). 26. 6. eta. see te Se ea ee ee fastboot(8) 
checknr: check nroff/troff files. ............. checknr(1) 
CHESS 3 des ae Sah ae Gee htt GONE see aR AG GE chess(6) 
chess: the game of chess.  . . 2... 2.2 ee ee eee chess(6) 
chfn, chsh, passwd: change password file ......... chfn(1) 
chfn, chsh, passwd: change password fille ......... chsh(1) 
chfn, chsh, passwd: change password fille ......... passwd(1) 
chgrp: change group. ..... 2... ee ee ee eee chgrp(1) 
ching: the book of changes and other cookies. ....... ching(6) 
chmod: changemode. . .... 2... ee ee ee eee chmod(1) 
chmod: change mode ofafile. ..........06. chmod(3F) 
chmod: change mode of file. .........+.4.+2--. chmod(2) 
chown: change owner. . . 2... 6 ee ee ee ee eee chown(8) 
chown: change owner and group ofafile. ......... chown(2) 
chroot: change root directory. . .......4.6.4-+ee-. chroot(2) 
chsh, passwd: change password file information, ...... chfn(1) 
chsh, passwd: change password file information, ...... chsh(1) 
chsh, passwd: change password file information. ...... passwd(1) 
circle, arc, move, cont, point, linemod, space, ....... plot(3X) 
classification macros. /isprint, isgraph,iscntrl, ....... ctype(3) 
clatiséun switch." 6. ce 306 ae ek we OS te ie ER Sa esh(1) 
ClEANEUPS «6 Pe OSES ae ee eae Tee ot Ee tas BE ee ee ee uuclean(8C) 
clear: clearterminalscreen. . . 2... 2.2 ee eee eee clear(1) 
Clea TOSS. oo. roo ayes Say Son GS ow as GE Ge a EO, Se clri(8) 
clearterminalscreeni. > 6, -\5- gt ah eo bosieee le ene a ale ae SS clear(1) 
clearerr, fileno: stream status inquiries. .........-. ferror(3S) 
GaWKe Syntax, as le ea so ade et Be cal SE es wee esh(1) 
clock. adjtime: correct . 2... 2. eee ee ee ee adjtime(2) 
CLOCK, see fe: Se as hs Ge see dloies SP Sere Srer LANTOS aS Ses nee eee kg(4) 
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cron: 


shutdown: 

fclose, fflush: 

opendir, readdir, telldir, seekdir, rewinddir, 
syslog, openlog, 

circle, arc, move, cont, point, linemod, space, 


L. 


autoconf: diagnostics from the autoconfiguration 
pi: Pascal interpreter 


log. dmesg: 


colrm: remove 

files. 

exec: overlay shell with specified 
time: time 

routines for returning a stream to a remote 
rexec: return stream to a remote 
system: issue a shell 

system: execute a UNIX 

test: condition 
time: time a 
nice, nohup: run a 

switch: multi-way 

uux: unix to unix 

rehash: recompute 

unhash: discard 

hashstat: print 

nohup: run 

csh: a shell 
whatis: describe what a 

readonly, set, shift, times, trap, umask, wait: 
getarg, iargc: return 

L.cmds: UUCP remote 

repeat: execute 

rc: 

onintr: process interrupts in 
apply: apply a 

goto: 

else: alternative 

intro: introduction to 

introduction to system maintenance and operation 
resintro: introduction to RCS 

at: execute 

apropos: locate 

while: repeat 

lastcomm: show last 

source: read 

comm: select or reject lines 

socket: create an endpoint for 

pipe: create an interprocess 

bk: line discipline for machine-machine 
talkd: remote user 

dmc: DEC DMC-11/DMR-11 point-to-point 
dh: DH-11/DM-11 

dhu: DHU-11 

dz: DZ-11 

users: 

diff: differential file and directory 
cmp: 

diff3: 3-way differential file 

liszt: 

ce: C 

£77: Fortran 77 

pe: Pascal 

error: analyze and disperse 

yacc: yet another 

fp: Functional Programming language 
wait: wait for background processes to 
wait: await 

hypot, cabs: Euclidean distance, 
compress, uncompress, zcat: 
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clock daemon. 

close: delete a deseriptor: 

close down the system at a given de 

close or flush a stream. 

closedir: directory operations. . 
closelog, setlogmask: control system ibe: 
closepl: graphics interface. /erase, label, line, 
clri: clear i-node. 

cmds: UUCP remote eoninanelp permissions ete, 
cmp: compare two files. 

code. 

code translator. 

col: filter reverse line feeds. ‘ 
colert: filter nroff output for CRT previewing, 
collect system diagnostic messages to form error 
colrm: remove columns from a file. 
columns from a file. 

comm: select or reject lines common tot two esoned 
command. 

command. .......... 
command. rcemd, rresvport, ruserok: 
command. 

command. 

command. 

command. 

command. 

command at io pacdty ‘(sh gals 
command branch. 

command execution. 

command hash table. 

command hash table. 

command hashing statistics. 

command immune to hangups. 

(command interpreter) with C-like Syntax. 
command is. 

command language. fexeo; exit, ‘export, ‘login, read, 
command line arguments. 

command permissions file. 

command repeatedly. 

command script for auto-reboot and daeirous: 
command scripts. F 

command to a set of aon: 

command transfer. 

commands. 

commands. 

commands. intro: 

commands. 

commands at a later tie. 

commands by keyword lookup. 

commands conditionally. - 
commands executed in reverse order. 
commands from file. 

common to two sorted files. 
communication. 

communication chantiel, 

communication (obsolete). 

communication server. 

communications device. 

communications multiplexer. 
communications multiplexer. 
communications multiplexer. 

compact list of users who are on the siStbant 
comparator. 

compare two files. 

comparison. ae A 

compile a Franz Lise i program. 

compiler. 

compiler. 

compiler. oh 

compiler error messages. 
compiler-compiler. 

compiler/interpreter. 

complete. ath 

completion of process. 

complex absolute value. 

compress and expand data. 
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cron(8) 
close(2) 
shutdown(8) 
fclose(3S) 
directory(3) 
syslog(3) 
plot(3X) 
clri(8) 
L.cmds(5) 
cmp(1) 
autoconf(4) 
pi(1) 
col(1) 
colcrt(1) 
dmesg(8) 
colrm(1) 
colrm(1) 
comm(1) 
esh(1) 
esh(1) 
remd(3) 
rexec(3) 
system(3) 
system(3F) 
test(1) 
time(1) 
nice(1) 
esh(1) 
uux(1C) 
esh(1) 
esh(1) 
esh(1) 
esh(1) 
esh(1) 
whatis(1) 
sh(1) 
getarg(3F) 
L.cmds(5) 
esh(1) 
rc(8) 
esh(1) 
apply(1) 
esh(1) 
esh(1) 
intro(1) 
intro(8) 
resintro(1) 
at(1) 
apropos(1) 
esh(1) 
lastcomm(1) 
esh(1) 
comm(1) 
socket(2) 
pipe(2) 
bk(4) 
talkd(8C) 
dmc(4) 
dh(4) 
dhu(4) 
dz(4) 
users(1) 
diff(1) 
cmp(1) 
diff3(1) 
liszt(1) 
cc(1) 
f77(1) 
pe(1) 
error(1) 
yacc(1) 
fp(1) 
csh(1) 
wait(1) 
hypot(3M) 
compress(1) 
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data. 
learn: 
hangman: 


test: 

endif: terminate 

if: 

while: repeat commands 


gettytab: terminal 
resolver 

config: build system 
ifconfig: 


tip, cu: 

getpeername: get name of 

socketpair: create a pair of 

shutdown: shut down part of a full-duplex 
accept: accept a 

connect: initiate a 

listen: listen for 


dcheck: file system directory 

icheck: file system storage 

fsck: file system 

quotacheck: file system quota 

tu: VAX-11/730 and VAX-11/750 TU58 

fl: 

cons: VAX-11 

crl: VAX 8600 

show what versions of object modules were used to 
mkfs: 

newfs: 

mkproto: 

deroff: remove nroff, troff, tbl and eqn 
setrlimit: control maximum system resource 
vlimit: control maximum system resource 
/openpl, erase, label, line, circle, arc, move, 
badsect: create files to 

Is: list 

sigstack: set and/or get signal stack 

sh, for, case, if, while, : , . , break, 


arp: address resolution display and 
fentl: file 

ioctl: 

init: process 

getrlimit, setrlimit: 

vlimit: 

icmp: Internet 

Ipc: line printer 

timedc: timed 

tcp: Internet Transmission 

syslog, openlog, closelog, setlogmask: 
vhangup: virtually ‘‘hangup’’ the current 
uda: UDA-50 disk 

up: unibus storage module 

term: 

ecvt, fevt, gcevt: output 

long, short: integer object 

printf, fprintf, sprintf: formatted output 
scanf, fscanf, sscanf: formatted input 
units: 

ns_addr, ns_ntoa: Xerox NS(tm) address 
dd: 


number: 

ranlib: 

atof, atoi, atol: 

ctime, localtime, gmtime, asctime, timezone: 
htable: 

bed: 

htonl, htons, ntohl, ntohs: 

ad: Data Translation A/D 

ching: the book of changes and other 

arff, flcopy: archiver and 


cp: 
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compress, uncompress, zcat: compress and expand 
computer aided instruction about UNIX. 
Computer version of the game hangman. 
comsat: biff server. 

condition command. 

conditional. 

conditional statement. 

conditionally. 

config: build system Sonnmutation files. 
configuration data base. 

configuration file. 

configuration files. 

configure network interface paraieters: 
connect: initiate a connection on a socket. 
connect to a remote system. 

connected peer. 

connected sockets. 

connection. 

connection on a socket 

connection on a socket. 

connections on a socket. 

cons: VAX-11 console interface. 
consistency check. 

consistency check. . 
consistency check and iniemictive repair. 
consistency checker. 

console cassette interface. 

console floppy interface. 

console interface. 

console RLO2 interface. 

construct a file. what: 

construct a file system. 

construct a new file system. 

construct a prototype file system. 
constructs. 

consumption. getimit 

consumption. 

cont, point, linemod, space, “closepl: graphics/ 
contain bad sectors. 

contents of ae 

context. 

continue, cd, eval, exec, exit, export, login, a. 
continue: cycle in loop. 

control. 

control. 

control device. 

control initialization. 

control maximum system resource Consumption, 
control maximum system resource consumption. 
Control Message Protocol. 

control program. 

control program. 

Control Protocol. 

control system log. 

control terminal. 

controller interface. 

controller/drives. 5 
conventional names for fetmninals; 
conversion. 

conversion. 

conversion. 

conversion. j 

conversion program. 

conversion routines. 

convert and copy a file. Noe 
convert Arabic numerals to English. 
convert archives to random libraries. 
convert ASCII to numbers. . 

convert date and time to ASCII. 

convert NIC standard format host tables. 
convert to antique media. 


convert values between host and network byte omer 


converter. 
cookies. 
copier for flonpy:. 


copy. 
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compress(1) 
learn(1) 
hangman(6) 
comsat(8C) 
test(1) 
esh(1) 
esh(1) 
esh(1) 
config(8) 
gettytab(5) 
resolver(5) 
config(8) 
ifconfig(8C) 
connect(2) 
tip(1C) 
getpeername(2) 
socketpair(2) 
shutdown(2) 
accept(2) 
connect(2) 
listen(2) 
cons(4) 
dcheck(8) 
icheck(8) 
fsck(8) 
quotacheck(8) 
tu(4) 

f1(4) 
cons(4) 
crl(4) 
what(1) 
mkfs(8) 
newfs(8) 
mkproto(8) 
deroff(1) 
getrlimit(2) 
vlimit(3C) 
plot(3X) 
badsect(8) 
Is(1) 
sigstack(2) 
sh(1) 

csh(1) 
arp(8C) 
fentl(2) 
ioctl(2) 
init(8) 
getrlimit(2) 
vlimit(3C) 
icmp(4P) 
Ipe(8) 
timedc(8) 
tcp(4P) 
syslog(3) 
vhangup(2) 
uda(4) 
up(4) 
term(7) 
ecvt(3) 
long(3F) 
printf(3S) 
scanf(3S) 
units(1) 
ns(3N) 
dd(1) 
number(6) 
ranlib(1) 
atof(3) 
ctime(3) 
htable(8) 
bed(6) 
byteorder(3N) 
ad(4) 
ching(6) 
arff(8V) 
ep(1) 
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rcp: remote file 

uucp: unix to unix 

dd: convert and 

tcopy: 

fork: create a 

remainder, exponent manipulations. 
copysign, drem, finite, logb, scalb: 
savecore: save a 


gcore: get 

system clock. adjtime: 
functions and their inverses. sin, 
sinh, 

we: word 

sum: sum and 


crash: what happens when the system 


fork: 

creat: 

open: open a file for reading or writing, or 
fork: 

socketpair: 

ctags: 

socket: 

mkstr: 

pipe: 

badsect: 

addbib: 

catman: 

umask: change or display file 
umask: set file 

cribbage: the card game 


Ixref: lisp 

pxref: Pascal 

systat: display system statistics on a 
colcrt: filter nroff output for 

more, page: file perusal filter for 


syntax. 


pel: DEC 


convert date and time to ASCII. 

time, 

tip, 

cbrt, sqrt: 

vhangup: virtually ‘‘hangup’’ the 
gethostid, sethostid: get/set unique identifier of 
gethostname, sethostname: get/set name of 
hostnm: get name of 

hostid: set or print identifier of 

hostname: set or print name of 

jobs: print 

sigsetmask: set 

whoami: print effective 

chdir: change 

getcwd: get pathname of 

getwd: get 

motion. 

curses: screen functions with ‘‘optimal’’ 
spline: interpolate smooth 

continue: 

cron: clock 

Ipd: line printer 

routed: network routing 

timed: time server 

XNSrouted: NS Routing Information Protocol 
rc: command script for auto-reboot and 
ftpd: 
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copy. 
copy. .. 

copy a file. 

copy a mag tape. 

copy of this process. 

copysign, drem, finite, logb, gealb: copys: 
copysign, remainder, exponent manipulations. 
core dump of the operating system. 

core: format of memory image file. 

core images of running processes. 

correct the time to allow synchronization of fhe. 
cos, tan, asin, acos, atan, atan2: trigonometric 
cosh, tanh: eee, functions. 

count. F 

count blocks in a ‘file: 

cp: copy. 

crash: what ipens when ihe gate erashes: 
crashes. 

creat: create a new file. 

create a copy of this process. 

create a new file. 

create a new file. 

create a new process. F 

create a pair of connected sockets: 

create a tags file. 

create an endpoint for communication. 


create an error message file by massaging C source. 


create an interprocess communication channel. 
create files to contain bad sectors. 

create or extend bibliographic database. 

create the cat files for the manual. 

creation mask. 

creation mode mask. 

cribbage. ‘ 

cribbage: the card game cabbage: 

crl: VAX 8600 console RLO2 interface. 

cron: clock daemon. 

cross reference program. 

cross-reference program. 

crt. a ee Te ye te 

CRT previewing. 

crt viewing. 

crypt: sidodeidecode. 

crypt, setkey, encrypt: DES encryption, 

csh: a shell (command interpreter) with C-like 
css: DEC IMP-11A LH/DH IMP interface. 
CSS PCL-11 B Network Interface. 

ct: phototypesetter interface. 

ctags: create a tags file. Salat eee 
ctime, localtime, gmtime, asctime, timezone: 
ctime, ltime, gmtime: return system time. 

cu: connect to a remote system. 

cube root, square root. 

current control terminal. 

current host. 

current host. 

current host. 

current host system. 

current host system. 

current job list. 

current signal mask. 

current user id. 

current working aicctony. 

current working directory. 

current working directory pathnartie: > 
curses: screen functions with ‘‘optimal’’ cursor 
cursor motion. 

curve. eee 

cycle in loop. 

daemon. 

daemon. 

daemon. 

daemon. 

daemon. 

daemons. : 
DARPA Internet File Tranter Pratcol server. 
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rep(1C) 
uucp(1C) 
dd(1) 
tcopy(1) 
fork(3F) 
ieee(3M) 
ieee(3M) 
savecore(8) 
core(5) 
gcore(1) 
adjtime(2) 
sin(3M) 
sinh(3M) 
we(1) 
sum(1) 
ep(1) 
crash(8V) 
crash(8V) 
creat(2) 
fork(3F) 
creat(2) 
open(2) 
fork(2) 
socketpair(2) 
ctags(1) 
socket(2) 
mkstr(1) 
pipe(2) 
badsect(8) 
addbib(1) 
catman(8) 
esh(1) 
umask(2) 
cribbage(6) 
cribbage(6) 
crl(4) 
cron(8) 
Ixref(1) 
pxref(1) 
systat(1) 
colcrt(1) 
more(1) 
crypt(1) 
crypt(3) 
csh(1) 
css(4) 
pel(4) 

ct(4) 
ctags(1) 
ctime(3) 
time(3F) 
tip(1C) 
sqrt(3M) 
vhangup(2) 
gethostid(2) 
gethostname(2) 
hostnm(3F) 
hostid(1) 
hostname(1) 
esh(1) 
sigsetmask(2) 
whoami(1) 
chdir(2) 
getcwd(3F) 
getwd(3) 
curses(3X) 
curses(3X) 
spline(1G) 
esh(1) 
cron(8) 
Ipd(8) 
routed(8C) 
timed(8) 
XNSrouted(8C) 
re(8) 
ftpd(8C) 
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whois: 

telnetd: 

tftpd: 

compress, uncompress, zcat: compress and expand 
eval: re-evaluate shell 

gprof: display call graph profile 

prof: display profile 

ttys: terminal initialization 

gettytab: terminal configuration 

hosts: host name 

networks: network name 

phones: remote host phone number 

printcap: printer capability 

protocols: protocol name 

services: service name 

termcap: terminal capability 

verindefs: vgrind’s language definition 
newaliases: rebuild the 

dbminit, fetch, store, delete, firstkey, nextkey: 
dbm_firstkey, dbm_nextkey, dbm_error, dbm_clearerr: 
brk, sbrk: change 

null: 

ad: 

types: primitive system 

addbib: create or extend bibliographic 
roffbib: run off bibliographic 

sortbib: sort bibliographic 

keys. map3270: 

join: relational 

idp: Xerox Internet 

udp: Internet User 

date: print and set the 

gettimeofday, settimeofday: get/set 

time, ftime: get 

fdate: return 

localtime, gmtime, asctime, timezone: convert 
touch: update 

idate, itime: return 


dbm_delete, dbm_firstkey, dbm_nextkey, dbm_error, 
dbm_firstkey, dbm_nextkey, dbm_error,/ dbm_open, 
dbm_open, dbm_ close, dbm_fetch, dbm_store, 
/dbm_store, dbm_delete, dbm_firstkey, dbm_nextkey, 
dbm_nextkey, dbm_error,/ dbm_open, dbm_close, 
data/ /dbm_close, dbm_fetch, dbm_store, dbm_delete, 
data base subroutines. 

/dbm_fetch, dbm_store, dbm_delete, dbm_firstkey, 
dbm_delete, dbm_firstkey, dbm_nextkey, dbm_error,/ 
dbm_error,/ dbm_open, dbm_close, dbm_fetch, 


dbx: 


ddn: 


adb: 

dbx: 

pdx: pascal 
pel: 

qe: 

de: 

device. dmc: 
css: 

IX: 

bad144: read/write 
tmscp: 

od: octal, 

tp: 


chdir: change 

diskpart: calculate 
verindefs: vgrind’s language 
eqnchar: special character 
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- XXXili - 
DARPA Internet user name directory service. ....... whois(1) 
DARPA TELNET protocol server. . . 2... 2.6 ee eee telnetd(8C) 
DARPA Trivial File Transfer Protocol server. ....... tftpd(8C) 
Catas, sates is vel ce oge Pa" S2 oF -Bl cay co? tay WS ob dee Sans ta NSD os ean es compress(1) 
ALAS es 4x Te ce~ ces Deda t he Be sede? bactbet Gol Tepe sev bed veh oy "eevee Set Le esh(1) 
alta 2. 5 de tea eh te odo eh a ew. Le od el Pitas Seo AES gprof(1) 
ataie ease Mk oh al eed ote Gee Ta ae Oe A od prof(1) 
ata fe ie. Sh SY tes Re cth ibeteg sien Seca a BO a tee week ttys(5) 
database? . si 62s rope iat a a) fe tee ak Se EL gettytab(5) 
Catabases, ss sv My id ET fects a ol, Si te ea fe hosts(5) 
data bases wie. ee sare IE he we ale as networks(5) 
data base:. . sea ae Sense la a, Oe, Bae EE a ee phones(5) 
data DASE? se 2a5° age a te ta eee Ge Rare os ase seared printcap(5) 
ata PASC id=, set Sete es erie iets She uote Soe el Sot tees Ger ae ae Se oe protocols(5) 
Calta Bases soo ses Sos et es Le es a es nes a RT eee cas nes services(5) 
data bases. sees” ere ie sg ta ee aie UG ie oa Ee Se ee termcap(5) 
data bas: <% <. Side tassios Ae cenad) yaad Ee. ce east eH ae GE verindefs(5) 
data base for the mail aliases file. .........2.6- newaliases(1) 
data base subroutines. . . 2... 2 ee ee ee ee dbm(3X) 
data base subroutines. /dbm_store,dbm delete, ...... ndbm(3) 
dataseesmentsize::  s.cay Ge cawcai te Ger teed Cen tas Up ek SU ae Se brk(2) 
ata-sink? - 34) temiwe ey ete ao te Ne Heed Set Mite ee ao bs null(4) 
Data Translation A/D converter. . . 2... 2 7 ee eee ad(4) 
Cataitypess | sls ee Sear ige tae HE ee ee at SP Ge a types(5) 
databases, ~. s <s; 5. Se eect ao SRe. h ke SE eal eS addbib(1) 
databasecs nc. hc grate che Se Sok. whe Se he CE aes OS SEIS roffbib(1) 
databases \ie- 2b goad ecei ls Sek Geneve olsisaar Sen deere te ee ae Sol sortbib(1) 
database for mapping ascii keystrokes into IBM 3270 . map3270(5) 
database operator, . 2... 6 1 ee ee ee ee ee join(1) 
Datagram Protocol . . 1.1... 6 eee ee ee ee ee idp(4P) 
Datagram Protocol . . 1... 6. ee ee ee ee ee udp(4P) 
ALE: 15, Geis pis hte tae tats Sg RL kde OS TON a te ates ie te tee te: wa ae date(1) 
date-and TIME. aes. S08 Mee Se eh the 8s we Tee ce ce Tis ee aed gettimeofday(2) 
date-and:times: «68 Sie. Wis eh ees Se eee ee ee time(3C) 
date and time inan ASCII string. .........2..-. fdate(3F) 
date and time to ASCII. ctime, ...........2.- ctime(3) 
date last modified ofafile. . ........2+60624286- touch(1) 
date or time innumericalform. ..........4.24.2- idate(3F) 
date: printandsetthedate. ..........624-+26. date(1) 
dbm_clearerr: data base subroutines. /dbm_store, ...... ndbm(3) 
dbm_close, dbm_fetch,dbm_store,dbm delete, ...... ndbm(3) 
dbm_delete, dbm_firstkey, dbm_nextkey, dbm_error,/ ndbm(3) 
dbm_error, dbm_clearerr: data base subroutines. ...... ndbm(3) 
dbm_fetch, dbm_store, dbm_delete,dbm firstkey, ..... ndbm(3) 
dbm_firstkey, dbm_nextkey, dbm_error, dbm_clearerr: ndbm(3) 
dbminit, fetch, store, delete, firstkey, nextkey: ....... dbm(3X) 
dbm_nextkey, dbm_error,dbm_clearerr:database/X’ . . . . ndbm(3) 
dbm_open, dbm_ close, dbm_fetch,dbm store, ....... ndbm(3) 
dbm_store, dbm_delete, dbm_firstkey, dbm_nextkey, ndbm(3) 
dbx: dbx symbol table information. ........... dbx(5) 
dbx: debugger: ss. cs seo es de, AF ee we dbx(1) 
dbx symbol table information, ............. dbx(5) 
de: desk'caletilators, co:<er te: sega ua Ss ser ce ap ee Soe) GE we et 3 dce(1) 
dcheck: file system directory consistency check. ...... dcheck(8) 
dd: convert andcopyafile. ..........624-+2-. dd(1) 
ddn: DDN Standard Mode X.25 IMP interface. .... 2... ddn(4) 
DDN Standard Mode X.25 IMP interface. ......... ddn(4) 
de: DEC DEUNA 10 Mb/s Ethernet interface. . ... 2... de(4) 
CeDUS GEE: osc Sete eed adh Se ee es Be Dee a ee SE adb(1) 
CebUSPErs. ok oo ies wee “bo Wee SE et Be GE Sa ie Gn a ae dbx(1) 
debusgere vs. asec fe ve sae. ete eee Oe. Cae al-Rce pdx(1) 
DEC CSS PCL-11 B Network Interface. .......4.. pel(4) 
DEC DEQNA Q-bus 10 Mb/s Ethernet interface. . ..... qe(4) 
DEC DEUNA 10 Mb/s Ethernet interface. . . ....... de(4) 
DEC DMC-11/DMR-11 point-to-point communications dmc(4) 
DEC IMP-11A LH/DHIMPinterface. .......... css(4) 
DEC RX02 floppy disk interface. ........2.2--. rx(4) 
dec standard 144 bad sector information. ......... bad144(8) 
DEC TMSCP magtape interface. ........22-. tmscp(4) 
decimal, hex, asclidump. .......-6.-6.2-80.64 od(1) 
DEC/mag tape formats. . . 2... 6 ee ee ee ee ee tp(5) 
default: catchall clause inswitche . ........068-4 esh(1) 
default: diréctOrys: -s, Bier aan ab weak ee ORE ny ee chdir(3F) 
default disk partition sizes. . 2... 1. ee ee ee eee diskpart(8) 
definition database. . 2. 6. 1 eee ee ee ee ee verindefs(5) 
definitions foreqn. .. 1... 1 eee ee ee ee ee eqnchar(7) 
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stty, gtty: set and get terminal state (defunct), . 2... 1 ee ee ee ee ee ee ee stty(3C) 
close: deleteadescriptor. ... 1... 2 ee ee ee eee close(2) 
dbminit, fetch, store, delete, firstkey, nextkey: data base subroutines. . ...... dbm(3X) 
tail: deliver the last partofafile. ...........2.2.6- tail(1) 
mesg: permitor deny messages. ... 1... ee ee ee ee eer eee mesg(1) 
tset: terminal dependentinitialization, ..........4.-+4.2e4.2- tset(1) 
qe: DEC DEQNA Q-bus 10 Mb/s Ethernet interface. . ....... qe(4) 
constructs. deroff: remove nroff, troff,tblandeqn .......... deroff(1) 
crypt, setkey, encrypt: DESencryption. . . 2... 1 1 ee ee ee ee ee ee crypt(3) 
whatis: describe whatacommandis. ........4+4+-e2ee- whatis(1) 
mailaddr: mail addressing description. . . . 1... 1 eee ee ee ee ee mailaddr(7) 
getdiskbyname: get disk description byitsname. . .. 2... 2 ee ee eee ee getdisk(3) 
disktab: disk description file. .... 1... 2... ee eee ee ee disktab(5) 
L-devices: UUCP device description file. ..........0-2-20-0-50-e-+2008 L-devices(5) 
L.sys: UUCP remote host description file. . 2... 2 ee ee ee ee ee ee L.sys(5) 
remote: remote host description file. . . 2... 2. ee ee eee eee ee remote(5) 
close: deletea descriptor. . . 2... 2 ee ee ee ee ee ee close(2) 
dup, dup2: duplicatea descriptor. . .. 2... ee ee ee ee ee ee ee dup(2) 
getfstype, setfsent, endfsent: get file system descriptor file entry. /getfsspec, getfsfile, ......... getfsent(3) 
getdtablesize: get descriptortable size. . . 1... 2... eee ee ee ee getdtablesize(2) 
de: desk-Calculatoté = 13> yo: ak te Ose 6: a Set YE Sahn SE Li dce(1) 
access: determine accessability ofafile. . .........2.2.- access(3F) 
access: determine accessibility of file. . ..........2.2.2. access(2) 
file: determine filetype. . .. 2... 2... ee eee eee file(1) 
de: DEC DEUNA 10 Mb/s Ethernet interface. . ........2.2- de(4) 
DEC DMC-11/DMR-11 point-to-point communications device. dmc: «1 ww we ee ee ee ee ee ee dmc(4) 
druin:pagine: devices: <0 35 ss. Se ec ES ea a ee drum(4) 
fold: fold long lines for finite width output device. . 2. 6. 1 eee ee ee ee ee fold(1) 
dOcthcontrol AdEVICE.:, 5: be, Mea ea cw Sy Pan oh eae eee ae ai ORS ioctl(2) 
L-devices: UUCP device descriptionfile. ...........6-2-+.2-0. L-devices(5) 
swapon: add a swap device for interleaved paging/swapping. .......... swapon(2) 
swapon: specify additional device for paging and swapping. .........-+.e. swapon(8) 
ik: Ikonas frame buffer, graphics deviceinterface. . . 2... 1 ee ee ee ee ee ik(4) 
ps: Evans and Sutherland Picture System 2 graphics deviceinterface. . 2. 1. 1 1 ee ee ee ee ee ee ps(4) 
tb: line discipline for digitizing devices. . .. 1... eee ee ee ee ee eee tb(4) 
dE disk frees ot ien tas ws eA. Sed ho ss ae Re Sees df(1) 
filmin, flmax, ffrac, dflmin, dflmax, dffrac, inmax: returnextreme values. . .......244- flmin(3F) 
fimin, fimax, ffrac, dflmin, dflmax, dffrac, inmax: return extreme values. . ....... fimin(3F) 
values. fimin, flmax, ffrac, dflmin, dflmax, dffrac,inmax:returnextreme ....... flmin(3F) 
dh: DH-11/DM-11 communications multiplexer. ...... dh(4) 
dh: DH-11/DM-11 communications multiplexer. . ....... dh(4) 
dhu: DHU-11 communications multiplexer. ........ dhu(4) 
dhu: DHU-11 communications multiplexer. .......... dhu(4) 
dmesg: collect system diagnostic messages toformerrorlog, .........-. dmesg(8) 
autoconf: diagnostics from the autoconfigurationcode. ........ autoconf(4) 
explain: print wordy sentences; thesaurus for diction. diction, ....... 2.56. -+ 2 ee ee eee diction(1) 
for diction. diction, explain: print wordy sentences; thesaurus ...... diction(1) 
diff: differential file and directory comparator. ....... diff(1) 
patch: a program for applyinga difffiletoanoriginal . 2... . 2... 2 ee eee eee patch(1) 
diff3: 3-way differential filecomparison. ......... diff3(1) 
diff: differential file and directory comparator. ......... diff(1) 
diff3: 3-way differential filecomparison. .........-4+02804 diff3(1) 
tb: line discipline for digitizing devices. . .. 1... eee eee ee ee we tb(4) 
dir: format of directories.  . ......-650502 2000 dir(5) 
dir: format of directories. . 2... 1 ee ee ee ee ee ee dir(5) 
rm, rmdir: remove (unlink) files or directories. . . 1... 6 ee ee we ee ee ew ee rm(1) 
sticky: persistent text and append-only directories. . 2... 1. 6 1 ee eee ee ee ee ee sticky(8) 
rmdir, rm: remove (unlink) directories or files; 1... 2... 1 2 ee ee ee ee ne rmdir(1) 
cd: change working directory, . 2... 6 1 ee ee ee ee ee ee ee cd(1) 
chdir: change current working directory. . . 2... 1 ee ee ee ee ee ee ee chdir(2) 
chdir: change default directory, 2... 2 1 ee ee ee ee ee ee ee chdir(3F) 
chroot: change root directory, . 2... 6 1 eee ee ee ee ee ee chroot(2) 
cd:change directory. . 2... 1. ee ee ee eee ee ee ee csh(1) 
chdir! change-<directotys: <<: 000 ete dh ceeee Bie ee eS A csh(1) 
getcwd: get pathname of current working directory. 2... 1 1 ee ee ee ee ee ee ee getcwd(3F) 
Is: list contents of directory. . 2... 1 ee ee ee ee ee ee Is(1) 
mkdir: makea directory. . .. 1... 2 ee ee ee ee ee ee eee mkdir(1) 
scandir, alphasort: scana directory. . 2. 6 ee ee ee ee ee ee ee ee scandir(3) 
uuclean: uucp spool directoryclean-up. . . 2... 1. 2 ee ee ee ee eee uuclean(8C) 
diff: differential fileand directorycomparator. . . 1... 6 6 eee eee eee diff(1) 
dcheck: file system directory consistency check. ........2-6-2+26- dcheck(8) 
unlink: remove directoryentry. ... 1... 5.26 ee ee wee ene unlink(2) 
unlink: removea directoryentry, . 2... 6 ee ew ee ee ee ee unlink(3F) 
mkdir: makea directory file ... 1... 2.2.5. - ee eee ewes mkdir(2) 
rmdir: removea directory file. . . 2... 2 ee ee ee ee ee ee rmdir(2) 
mklost+found: make a lost+found directory forfsck. . .. 2... 2 ee ee ee eee mklost+found(8) 
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pwd: working 

readdir, telldir, seekdir, rewinddir, closedir: 
getwd: get current working 

whois: DARPA Internet user name 

popd: pop shell 

pushd: push shell 

quota: display 

unhash: 

unset: 

tb: line 

(obsolete). bk: line 

synchronize a file’s in-core state with that on 
hk: RK6-11/RK06 and RKO7 moving head 
uda: UDA-50 

getdiskbyname: get 

disktab: 

df: 

hp: MASSBUS 

rx: DEC RX02 floppy 

format: how to format 

diskpart: calculate default 

quota: manipulate 

drtest: standalone 

du: summarize 


reboot/halt the system without checking the 
rxformat: format floppy 


mount, umount: mount and 
error: analyze and 

rain: animated raindrops 
arp: address resolution 
gprof: 

snake, snscore: 

quota: 

vi: screen oriented (visual) 
umask: change or 

prof: 

systat: 

sysline: 

worms: animate worms on a 
uulog: 

jove: an interactive 

hypot, cabs: Euclidean 
rdist: remote file 
communications device. 
dmc: DEC 

error log. 


dmf: 
dmz: 


dn: 
res mkquery, res_send, res_init, 


directory name. 
directory operations. opendir, 
directory pathname. 
directory service. 
directory stack. 
directory stack. 
disc usage and limits. 
discard command hash table. 
discard shell variables. 
discipline for digitizing devices. 
discipline for machine-machine communication 
disk. fsync: 
disk. 
disk controller interface. 
disk description by its name. 
disk description file. 
disk free. 
disk interface. 
disk interface. 
disk packs. 
disk partition sizes. 
disk quotas. 
disk test program. 
disk usage. 
diskpart: calculate default disk partition sizes. 
disks. fastboot, fasthalt: 
disks. 
disktab: disk description file. 
dismount file system. 
disperse compiler error messages. 
display. 
display and control. 
display call graph profile data. 
display chase game. 
display disc usage and limits. 
display editor based on ex. 
display file creation mask. 
display profile data. 
display system statistics on a crt. 
display system status on status line of a terminal. 
display terminal. 
display UUCP log files. 
display-oriented text editor. 
distance, complex absolute value. 
distribution program. 
dmc: DEC DMC-11/DMR-11 point-to-point 
DMC-11/DMR-11 point-to-point communications device. 
dmesg: collect system diagnostic messages to form 
dmf: DMF-32, terminal multiplexor. 
DMF-32, terminal multiplexor. 
dmz: DMZ-32 terminal multiplexor. 
DMZ-32 terminal multiplexor. 
dn: DN-11 autocall unit interface. 
DN-11 autocall unit interface. 
dn_comp, dn_ expand: resolver routines. 


res_mkquery, res_send, res init, dn_comp, 


dn_expand: resolver routines. 


style: analyze surface characteristics of a 
refer: find and insert literature references in 
w: who is on and what they are 

named: Internet 

rogue: Exploring The Dungeons of 
shutdown: shut 

shutdown: close 

rand, 

random, 

graph: 

exponent manipulations. copysign, 
arithmetic: provide 

ut: UNIBUS TU45 tri-density tape 

pty: pseudo terminal 


etime, 


dump: incremental file system 
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doctor: interact with a psychoanalyst. 
document. 
documents. 
doing. 
domain name server. 
Doom. 
down part of a full-duplex connection. 
down the system at a given time. 
drand, irand: return random values. 
drandm, irandm: better random number generator. 
draw a graph. 
drem, finite, logb, scalb: copysign, remainder, 
drill in number facts. 
drive interface. 
driver. 
drtest: standalone disk test program. 
drum: paging device. 
dtime: return elapsed execution time. 
du: summarize disk usage. 
dump. 
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pwd(1) 
directory(3) 
getwd(3) 
whois(1) 
esh(1) 
esh(1) 
quota(1) 
esh(1) 
esh(1) 
tb(4) 

bk(4) 
fsync(2) 
hk(4) 
uda(4) 
getdisk(3) 
disktab(5) 
df(1) 

hp(4) 

1x(4) 
format(8V) 
diskpart(8) 
quota(2) 
drtest(8) 
du(1) 
diskpart(8) 
fastboot(8) 
rxformat(8V) 
disktab(5) 
mount(8) 
error(1) 
rain(6) 
arp(8C) 
gprof(1) 
snake(6) 
quota(1) 
vi(1) 
esh(1) 
prof(1) 
systat(1) 
sysline(1) 
worms(6) 
uulog(1C) 
jove(1) 
hypot(3M) 
rdist(1) 
dmc(4) 
dmc(4) 
dmesg(8) 
dmf(4) 
dmf(4) 
dmz(4) 
dmz(4) 
dn(4) 

dn(4) 
resolver(3) 
resolver(3) 
doctor(6) 
style(1) 
refer(1) 
w(1) 
named(8) 
rogue(6) 
shutdown(2) 
shutdown(8) 
rand(3F) 
random(3F) 
graph(1G) 
ieee(3M) 
arithmetic(6) 
ut(4) 

pty(4) 
drtest(8) 
drum(4) 
etime(3F) 
du(1) 
dump(8) 
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od: octal, decimal, hex, ascii 
rdump: file system 
rrestore: restore a file system 


dumpfs: 
dump, dumpdates: incremental 


savecore: save a core 
kgmon: generate a 
dump, 


zork: the game of 
rogue: Exploring The 


dup, 
dup, dup2: 


dz: 


echo: 
echo: 


ping: send ICMP 


end, etext, 

ex, 

vipw: 

edquota: 

ed: text 

ex, edit: text 

jove: an interactive display-oriented text 
Id: link 

sed: stream 

vi: screen oriented (visual) display 
a.out: assembler and link 


whoami: print 

setregid: set real and 

setreuid: set real and 

vfork: spawn new process in a virtual memory 


grep, 

etime, dtime: return 

insque, remque: insert/remove 
soelim: 


setquota: 

nsip: software network interface 
uuencode: format of an 

crypt: 

mail. uuencode, uudecode: 
crypt, setkey, 

crypt, setkey, encrypt: DES 
makekey: generate 


secs: front 
logout: 


/getfsspec, getfsfile, getfstype, setfsent, 
getgrent, getgrgid, getgrnam, setgrent, 
gethostbyaddr, gethostent, sethostent, 


getnetent, getnetbyaddr, getnetbyname, setnetent, 
socket: create an 

getprotobynumber, getprotobyname, setprotoent, 
getpwent, getpwuid, getpwnam, setpwent, 
getservbyport, getservbyname, setservent, 


getttyent, getttynam, setttyent, 
getusershell, setusershell, 

number: convert Arabic numerals to 
xsend, xget, 

nlist: get 
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UMP: és cd. Shes Mater es el eS ee SI Se ee od(1) 
dump across the network. .......-2-2-60250206- rdump(8C) 
dump across the network, . . 2... 2.2.2. 2.2 ee eee rrestore(8C) 
dump, dumpdates: incremental dump format. ........ dump(5) 
dump file system information. . ... 2... 2.2.2. eee dumpfs(8) 
dump format. sss. e oe A ee ete Ss wee dump(5) 
dump: incremental filesystem dump. ........... dump(8) 
dump of the operating system. .........2-+2-. savecore(8) 
dump of the operating system’s profile buffers. ....... kgmon(8) 
dumpdates: incremental dump format. .......... dump(5) 
dumpfs: dump file system information. .......... dumpfs(8) 
GUASEON:... eh es Wee, Sve tee eis aR Ae SS, ee zork(6) 
DungeonsofDoom. ..... 2... ee ee ee eee rogue(6) 
dup, dup2: duplicateadescriptor. ............ dup(2) 
dup2: duplicateadescriptor. ..........2-+... dup(2) 
duplicate adescriptor, . . 6... 2 ee ee ee ee dup(2) 
dz: DZ-11 communications multiplexer. ......... dz(4) 
DZ-11 communications multiplexer. ........... dz(4) 
ec: 3Com 10 Mb/s Ethernet interface. . . 2... ...-. ec(4) 
ecCho‘argsuments: cds rie Scape eee es ee is tag re. Ge cee ve esh(1) 
ECHO-APSUMENS, © < S250 ay ce era Ln Sot aE Me eh aL Eh RS Le echo(1) 
echo: echo arguments. . .... 2... ee ee ee eee esh(1) 
echo: echo arguments. . .... 2... ee ee ee eee echo(1) 
ECHO_REQUEST packets to network hosts. ....... ping(8) 
ecvt, fevt, gcvt: output conversion. . . 2... ee ee eee ecvt(3) 
Cd? text ECILOI::) Mo, sé Shee we Se AE Saw ORE Be Le ES Ne PL ed(1) 
edata: last locations in program. . .... 2... 28 - end(3) 
SditstextieditOr:.. 6. ie. ees ow oe Rasy mes ce Se wie al dee ex(1) 
edit the password file. . . 2... 2... 2 ee ee ee we vipw(8) 
edit uSer Quotas.) «5° seed lush Seb re Ho ed de eS edquota(8) 
CdILOP.- S55. e cas Bee eae MS TAS cee aaed Eee Gea ete! 4 ed(1) 
CdilOL— tare So. Se OR ta Rak state See BON. Ge a RS ex(1) 
CdILOR:. aids 2g “ay can ie. toes he ted ae. ch tho 82 oe epee ce. a lsl Teg ceed jove(1) 
CdiLOE?- “Sie ta ae eee OE ees SE a ee Be a RS Id(1) 
editor: <5 0: 4 "ati le te: daa Ay atte a eat eo es ee eae & sed(1) 
editor basedonex. . 1... 2. 2 ee ee wwe ee wae vi(1) 
OdiLOr OUTPUTS wee ah Mate a te ea cca a.out(5) 
edquota: edituser quotas. .......-2.0-50-e-+2088 edquota(8) 
effective currentuserid. . 2... 1... eee eee eee whoami(1) 
effective groupID. ...... 2.2.52. eee ee ee setregid(2) 
effective userID’s. . . 2... ee eee ee we ee ne setreuid(2) 
efficientwayn- ste as eee oS eres Se Pe eet vfork(2) 
efl: Extended Fortran Language. . ........-+2-. efi(1) 
egrep, fgrep: searcha file forapattern. . .......2..- grep(1) 
elapsed executiontime. ..... 2... ee ee ee ee etime(3F) 
element fromaqueue. . 2... 1 ee ee eee ee ee insque(3) 
eliminate .so’s from nroffinput. ............. soelim(1) 
else: alternativecommands. .......4+4.6-24.e8e08-8 csh(1) 
en: Xerox 3 Mb/s Ethernet interface. . ........2-. en(4) 
enable/disable quotas ona filesystem. .........- setquota(2) 
encapsulating ns packets inip packets. .........-. nsip(4) 
éricoded tmencode file, «Kaw a oa Ke Ow RS uuencode(5) 
encode/decodes ~ 1265 4x dees: VP ae ar sel SSO Ae Ge Ms crypt(1) 
encode/decode a binary file for transmission via. ..... uuencode(1C) 
encrypt: DES encryption. . 2... 2... eee ee eee crypt(3) 
ENCLYPUOM ot Ae Mees oct Ge, Uh ERR el he EE SS Re crypt(3) 
encryptionkey. .... 2... ee ee ee eee ee makekey(8) 
end, etext, edata: last locations inprogram. ........ end(3) 
end for the SCCS subsystem. . 2... 2... eee eee sccs(1) 
Enid SESSION. 5 sos So se Be as See eS 8 ane ode aes esh(1) 
end: terminateloop. . .. 2... eee ee ee eee csh(1) 
endfsent: get file system descriptor fileentry. . ....... getfsent(3) 
endgrent: get group fileentry. ....... 2... ee ee getgrent(3) 
endhostent: get network host entry. gethostbyname, ..... gethostbyname(3N) 
endif: terminate conditional. ........6.6.24.28008-8 csh(1) 
endnetent: getnetwork entry. . ... 2... 2.5.2 ee ee getnetent(3N) 
endpoint forcommunication. ........-6.2. 2-56 - socket(2) 
endprotoent: get protocol entry. getprotoent, ........ getprotoent(3N) 
endpwent, setpwfile: get password fileentry. ........ getpwent(3) 
endservent: get service entry. getservent, ......... getservent(3N) 
endsw: terminate switch. . .. 2... 2. 2 ee ee eee csh(1) 
endttyent: get ttysfileentry, .... 2... 2... ee ee getttyent(3) 
endusershell: get legal user shells. . 2. 2... 2... 2.2. getusershell(3) 
English, (9% sca fe ge saw 6 el, ae is Dee ES eS wes number(6) 
enroll: secretmatl sy 526g det ses tener Se ae Soh Gee 8 oa, ea xsend(1) 
entries from name list. . 2... 6 ee ee ee ee ee nlist(3) 
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logger: make 

setfsent, endfsent: get file system descriptor file 
getgrnam, setgrent, endgrent: get group file 
sethostent, endhostent: get network host 
getnetbyname, setnetent, endnetent: get network 
setprotoent, endprotoent: get protocol 

setpwent, endpwent, setpwfile: get password file 
getservbyname, setservent, endservent: get service 
getttynam, setttyent, endttyent: get ttys file 

unlink: remove directory 

unlink: remove a directory 

execv, execle, execlp, execvp, exec, execve, exect, 


setenv: set variable in 

environ: user 

printenv: print out the 

window: window 

getenv: value for 

unsetenv: remove 

getenv: get value of 

eqnchar: special character definitions for 
deroff: remove nroff, troff, tbl and 


linemod, space, closepl: graphics/ plot: openpl, 


erf, 

messages. 

erf, erfc: 

dmesg: collect system diagnostic messages to form 
mkstr: create an 

error: analyze and disperse compiler 
perror, sys errlist, sys_nerr: system 
perror, gerror, ierrno: get system 
intro: introduction to system calls and 
spell, spellin, spellout: find spelling 
traper: trap arithmetic 

end, 

de: DEC DEUNA 10 Mb/s 

ec: 3Com 10 Mb/s 

en: Xerox 3 Mb/s 

ex: Excelan 10 Mb/s 

il: Interlan NI1010 10 Mb/s 

ix: Interlan Np100 10 Mb/s 

np: Interlan Np100 10 Mb/s 

qe: DEC DEQNA Q-bus 10 Mb/s 


hypot, cabs: 
/if, while, :, . , break, continue, cd, 


expr: 
device interface. ps: 
history: print history 
screen oriented (visual) display editor based on 


Ipq: spool queue 


uuq: 
ex: 

execl, execv, execle, execlp, execvp, 
/while, : , . , break, continue, cd, eval, 


exect, environ: execute a file. 

environ: execute a file. execl, execv, 
execute a file. execl, execv, execle, 

execl, execv, execle, execlp, execvp, exec, execve, 
execlp, execvp, exec, execve, exect, environ: 
execve: 

alarm: 

system: 

repeat: 

at: 

lastcomm: show last commands 

uux: unix to unix command 

acct: 

uuxqt: UUCP 
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entries in the system log. 4 

entry. getfsent, getfsspec, eetfsfile, eelfstype! 
entry. getgrent, getgrgid, . 

entry. gethostbyname, gethostbyaddr, gethostent, 
entry. getnetent, getnetbyaddr, ts te 
entry. /getprotobynumber, setprotobininine;- 
entry. getpwent, getpwuid, getpwnam, 
entry. getservent, getservbyport, 

entry. getttyent, 

entry. 25 pen 

entry. 

environ: eaeoutes a file. petal, 

environ: user environment. 

environment. 

environment. 

environment. 

environment. 

environment name. 

environment variables. 

environment variables. 

eqn. . 

eqn constructs. . 
eqn, neqn, checkeq: typeset mathematics, 
eqnchar: special character definitions for eqn. 
erase, label, line, circle, arc, move, cont, point, 
erf, erfc: error functions. 

erfc: error functions. ‘ 
error: analyze and disperse eoripilerd error 
error functions. 

error log. Z 
error message file byt massaging Cs source. 
error messages. 

error messages. 

error messages. 

error numbers. 

errors. 

errors. 7 

etext, edata: last locations in A pierann 
Ethernet interface. 

Ethernet interface. 

Ethernet interface. 

Ethernet interface. 

Ethernet interface. 

Ethernet interface. 

Ethernet interface. 

Ethernet interface. 

etime, dtime: return Siapeed erecatian dime, 
Euclidean distance, complex absolute value. 
eval, exec, exit, export, login, read, readonly,/ 
eval: re-evaluate shell data. 

evaluate arguments as an expression. 

Evans and Sutherland Picture aie 2 graphs 
event list. Meee goe3, & ts 
ex. Vi: 

ex, edit: text eaten. 

ex: Excelan 10 Mb/s Ethernet antereiees 
examination program. ‘ 
examine or manipulate the uucp queue. 
Excelan 10 Mb/s Ethernet interface. 

exec, execve, exect, environ: execute a file. 
exec, exit, export, login, read, readonly, set,/ 
exec: overlay shell with specified command. 


execl, execv, execle, execlp, execvp, exec, execve, 


execle, execlp, execvp, exec, execve, exect, 
execlp, execvp, exec, execve, exect, environ: 
exect, environ: execute a file. 

execute a file. execl, execv, execle, 
execute a file. : 

execute a subroutine after a Specified ame. 
execute a UNIX command. 

execute command repeatedly. 

execute commands at a later time. 

executed in reverse order. 

execution. 

execution abeousane file. 

execution file interpreter. 
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logger(1) 
getfsent(3) 
getgrent(3) 
gethostbyname(3N) 
getnetent(3N) 
getprotoent(3N) 
getpwent(3) 
getservent(3N) 
getttyent(3) 
unlink(2) 
unlink(3F) 
execl(3) 
environ(7) 
esh(1) 
environ(7) 
printenv(1) 
window(1) 
getenv(3) 
esh(1) 
getenv(3F) 
eqnchar(7) 
deroff(1) 
eqn(1) 
eqnchar(7) 
plot(3X) 
erf(3M) 
erf(3M) 
error(1) 
erf(3M) 
dmesg(8) 
mkstr(1) 
error(1) 
perror(3) 
perror(3F) 
intro(2) 
spell(1) 
traper(3F) 
end(3) 
de(4) 

ec(4) 

en(4) 

ex(4) 

il(4) 

ix(4) 

np(4) 

ge(4) 
etime(3F) 
hypot(3M) 
sh(1) 
esh(1) 
expr(1) 
ps(4) 
esh(1) 
vi(1) 

ex(1) 

ex(4) 
Ipq(1) 
uuq(1C) 
ex(4) 
execl(3) 
sh(1) 
esh(1) 
execl(3) 
execl(3) 
execl(3) 
execl(3) 
execl(3) 
execve(2) 
alarm(3F) 
system(3F) 
csh(1) 
at(1) 
lastcomm(1) 
uux(1C) 
acct(5) 
uuxqt(8C) 
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sleep: suspend 

sleep: suspend 

sleep: suspend 

usleep: suspend 

monitor, monstartup, moncontrol: prepare 
pxp: Pascal 

rexecd: remote 

etime, dtime: return elapsed 

profil: 

pix: Pascal interpreter and 

environ: execute a file. execl, 

execl, execv, execle, execlp, execvp, exec, 


file. execl, execv, execle, execlp, 

link: make a link to an 

tunefs: tune up an 

/:, ., break, continue, cd, eval, exec, 
breaksw: 


pending output. 


break: 

logarithm, power. 

glob: filename 

compress, uncompress, zcat: compress and 
expand, unexpand: 

versa. 

diction. diction, 

aardvark: yet another 

adventure: an 

rogue: 

logarithm, power. exp, 

frexp, ldexp, modf: split into mantissa and 
drem, finite, logb, scalb: copysign, remainder, 
exp, expm1, log, log10, loglp, pow: 

/ . , break, continue, cd, eval, exec, exit, 


expr: evaluate arguments as an 
re_comp, re_exec: regular 
addbib: create or 

efi: 

strings. xstr: 


ioinit: change 

libraries.. plot: openp! et al.: 

tclose, tread, twrite, trewin, tskipf, tstate: 
ceiling, and round-to-nearest functions. 
networking: introduction to networking 
signal: simplified software signal 

sigvec: software signal 

malloc, free, 

true, 


inet: Internet protocol 

ns: Xerox Network Systems(tm) protocol 
checking the disks. 

the disks. fastboot, 

abort: generate a 

trpfpe, fpecnt: trap and repair floating point 
export, login,/ sh, for, case, if, while, : , 
exit, export, login,/ sh, for, case, if, while, 


ecvt, 


fopen, freopen, 

ferror, 

inquiries. 

subroutines. dbminit, 

head: give first 

fclose, 

extreme values. fimin, flmax, 
bcopy, bemp, bzero, 


getc, 
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execution for an interval. 
execution for an interval. 
execution for interval. 
execution for interval. 
execution profile. 
execution profiler. 
execution server. 
execution time. 
execution time eae 
executor. 
execv, execle, execlp, eXecvp, exec, execve, execk 
execve, exect, environ: execute a file. 
execve: execute a file. 3 
execvp, exec, execve, exect, environ: execute a 
existing file. 
existing file system. 
exit, export, login, read, yeusonly: sel; shift/ 
exit from switch. 
exit: leave shell. 

_exit: terminate a process. 
exit: terminate a process after fishing a any 
exit: terminate process with status. 
exit while/foreach loop. : 
exp, expm1, log, log10, log1p, pow) "exponential, 
expand argument list. F 
expand data. 
expand tabs to spaces, oe vice versa. 
expand, unexpand: expand tabs to spaces, ana vice 
explain: print wordy sentences; thesaurus for 
exploration game. 
exploration game. 
Exploring The Dungeons af Doon : 
expm1, log, log10, eee pow: ysexponental, . 
exponent. 5 
exponent Aeaunations, copysign, 
exponential, logarithm, power. 
export, login, read, readonly, set, shift, ies: ie 
expr: evaluate arguments as an expression. 
expression. 
expression handler. 
extend bibliographic ditapase: 
Extended Fortran Language. 
extract strings from C programs to daplement aired 
f77: Fortran 77 compiler. 
f77 I/O initialization. 
f77 library interface to plot (3X) 
f77 tape I/O. topen, . 
fabs, floor, ceil, rint: absolute yalue, fear 
facilities. 
facilities. 
facilities. 
falloc: memory ‘lleestee: 
false: provide truth values. 
false, true: provide truth values. 
family. 
family. . . 
fastboot, fasthalt: ‘reboot/halt the system ‘without 
fasthalt: reboot/halt the system without checking 
fault. Per ar ee 
faults. 5 

, break, eentinue; oa Seal exec, Sak 

:, ., break, continue, cd, eval, exec, 
fclose, fflush: close or flush a stream. 
fentl: file control. 
fevt, gcvt: output conversion. 
fdate: return date and time in an ASCII sine: 
fdopen: open a stream. Aes ior tt a 
feof, clearerr, fileno: stream status inquiries. 
ferror, feof, clearerr, fileno: stream status 
fetch, store, delete, firstkey, ican data base 
few lines. XS fe es SF fe 
fflush: close or flush a sient: : 
ffrac, dflmin, dflmax, dffrac, inmax: eu 
ffs: bit and byte string operations. 
fg: bring job into foreground. 
fgetc: get a character from a logical unit. 
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sleep(1) 
sleep(3F) 
sleep(3) 
usleep(3) 
monitor(3) 
pxp(1) 
rexecd(8C) 
etime(3F) 
profil(2) 
pix(1) 
execl(3) 
execl(3) 
execve(2) 
execl(3) 
link(F) 
tunefs(8) 
sh(1) 
esh(1) 
esh(1) 
exit(2) 
exit(3) 
exit(3F) 
esh(1) 
exp(3M) 
esh(1) 
compress(1) 
expand(1) 
expand(1) 
diction(1) 
aardvark(6) 
adventure(6) 
rogue(6) 
exp(3M) 
frexp(3) 
ieee(3M) 
exp(3M) 
sh(1) 
expr(1) 
expr(1) 
regex(3) 
addbib(1) 
efi(1) 
xstr(1) 
f77(1) 
ioinit(3F) 
plot(3F) 
topen(3F) 
floor(3M) 
intro(4N) 
signal(3C) 
sigvec(2) 
malloc(3F) 
true(1) 
false(1) 
inet(4F) 
ns(4F) 
fastboot(8) 
fastboot(8) 
abort(3) 
trpfpe(3F) 
sh(1) 

sh(1) 
fclose(3S) 
fentl(2) 
ecvt(3) 
fdate(3F) 
fopen(3S) 
ferror(3S) 
ferror(3S) 
dbm(3X) 
head(1) 
fclose(3S) 
flmin(3F) 
bstring(3) 
esh(1) 
getc(3F) 
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getc, getchar, 

gets, 

grep, egrep, 

locate a program file including aliases and paths 
robots: 

access: determine accessibility of 

access: determine accessability of a 

acct: execution accounting 

chmod: change mode of 

chmod: change mode of a 

chown: change owner and group of a 

colrm: remove columns from a 

core: format of memory image 

creat: create a new 

source: read commands from 

ctags: create a tags 

dd: convert and copy a 

disktab: disk description 

execvp, exec, execve, exect, environ: execute a 
execve: execute a 

flock: apply or remove an advisory lock on an open 
fpr: print Fortran 

group: group 

L.aliases: UUCP hostname alias 

L.cmds: UUCP remote command permissions 
L-devices: UUCP device description 
L-dialcodes: UUCP phone number index 
link: make a hard link to a 

link: make a link to an existing 

L.sys: UUCP remote host description 

mkdir: make a directory 

mknod: make a special 

mknod: build special 

rebuild the data base for the mail aliases 

open a file for reading or writing, or create a new 
passwd: password 

pr: print 

remote: remote host description 

rename: change the name of a 

rename: rename a 

resolver configuration 

rev: reverse lines of a 

rmdir: remove a directory 

size: size of an object 

the printable strings in a object, or other binary, 
sum: sum and count blocks in a 

symlink: make symbolic link to a 

tail: deliver the last part of a 

touch: update date last modified of a 

uniq: report repeated lines in a 

USERFILE: UUCP pathname permissions 
uuencode: format of an encoded uuencode 
vipw: edit the password 

versions of object modules were used to construct a 
diff: differential 

bugfiler: 

mkstr: create an error message 

diff3: 3-way differential 

fentl: 

rcp: remote 

umask: change or display 

umask: set 


rdist: remote 

setfsent, endfsent: get file system descriptor 
getgrgid, getgrnam, setgrent, endgrent: get group 
setpwent, endpwent, setpwfile: get password 
getttynam, setttyent, endttyent: get ttys 

grep, egrep, fgrep: search a 

open: open a 

aliases: aliases 

uuencode, uudecode: encode/decode a binary 
ar: archive (library) 

tar: tape archive 

which: locate a program 

chfn, chsh, passwd: change password 
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PIES 0 os Warten 2 os ah Sed Vee Bae FOS 48d Geo Wines 8 a ca) SOGet Tee 8 the disktab(5) 
file. execl, execv, execle,execlp, ........2.+.2.. execl(3) 
TLCS ve S2F5Sc Wat, ee cas tde eb pss dat Mey oa: CEN paw tag ah Sy coud “Sed at tape ts execve(2) 
GILG 2, 5+ 0h Sie ates aa Sah ie dea tek Sg Gat Mak sds Wek ALOE Soh cde a tee OS flock(2) 
file: ie es Abate tes cee A SEs en tes St aise nee we a fpr(1) 

flees 5 ot a? te le Se a Gh ah ts ae a Ge SG! ok hg group(5) 
MUL e, “yobs or oe ee ttt LES OoM hr tee Geteck B9b tar te et iat week tee Temes Tt L.aliases(5) 
FES eae te, hE Wee Sah, BeBe WR eS, Mase S ae F L.cmds(5) 
AUS eee iene Sek SS ey wa REY, WS Say SEN Pease NEE Sok DVS eG bc SoS L-devices(5) 
FIGs), Sevecnh 22 oS as eave Seo I aes L-dialcodes(5) 
THe. > sey 8 oat ner id ~a, Oe ere Sees erie ee link(2) 

FSS ets a satel oh, Lee. Ta emcee tae a ab aoe hy fee a link(3F) 
MLC S?, ci ecad ade Shree Hee 4c GRudh Sat irene ence cee Seba Tae la eee oe L.sys(5) 
AEs.» Mes See Fey wee ee ses. Seas Seed oats Ce anne Goss e tahar fs mkdir(2) 
GLC oi. Sart ee Se ae gh Bias ee ieee BOO Ge. BN Rs mknod(2) 
TGS, sa srecty, Senco ce. Sets eater Se. ud the sa re “cepa cg. Chale Go Tee ened mknod(8) 
file, Mewaliases; —s..05 se Gah See BS eee ae newaliases(1) 
fIlE OPEN © 24 seis as Ay site Se dela wi ete wk, open(2) 
Files, ws gocss is a cnn Ge ta sd Ae Be asta tan SE Gee ae Ge AS Re Seve passwd(5) 
HINT Nee sae Pn css Sa LE Ae Yee aac dal Lathre Mas Pee, So cee ae ah Ay ted weet Le pr(1) 

fle end. Wee md waa em eed Bale tete e tial remote(5) 
files Secs ta ces alah bya eden. Mere oa be Sh eed FP 4d rename(2) 
ML e ret 2x Teneo Gee sere ak Tee we Paee eee RN Tee tae he tah ign Tae te Lee La rename(3F) 
files. eyes ih a8 ie Sw) Cx WS BOSSE SP ie V8 Rise Sk ae resolver(5) 
PLCs dy 05 Mey oh eae aE ok dog a ee od tee Se Pee a rev(1) 

Ce” ead cde sot Se ah ee Pecks Shes, GE ene ae SE rmdir(2) 
less ete Sons, ee Rees AE AE, Bee ie ae RAE Ge AS es size(1) 

file: strings: fittds: 60s ce ce ee ae es Pree BS ee ae strings(1) 
GIG. echt d. re Sh Sees sk dae at eae ee sa vee Soh ate bs eet Oe sum(1) 

MGs. hse 38a Ae age LSE cote Wee. BSR Aa ae OE oe symlink(2) 
TIER erases aps sect iste Ves tess do lee he a eee Ge RES tail(1) 

TCS, goersrey ee cotce 81s ve “Seed Eee Wet Go Hy coh ag Sao tist vas Mien touch(1) 
GLC, 654k Soe Pie eh eee a Get er TS oP PL SAE ce ee LS uniq(1) 

files sie Sete Ae Mites th ab i date AD Bi ete bes what e USERFILE(5) 
HGS ods a Gk ww at a Ma Sok TR Se at OS Kak OS i “et A Gh OS uuencode(5) 
FNS, os ae te, se tas Le Set AY Tee Goa LAL Ue tak ae Se A ee ota 1 vipw(8) 
file. what: show what ..... 1... ee eee wees what(1) 

file and directory comparator. . .......-6-2-e ee. diff(1) 

file bug reports in folders automatically. . ......... bugfiler(8) 
file by massaging C source. . 2 2. 1 eee ee ee ee mkstr(1) 
filecomparison. . . 1 6 ee ee eee ee ee ee diff3(1) 
filecontrol..: i633) Boa Sele, Sod de GE a EE fentl(2) 
FIELCOP Ys 2.8 aS wah Gere 8S eS ain bs eS. Led rep(1C) 
filecreationmask. ....... 5.2.20 eee ew eee esh(1) 

file creationmode mask. . .... 2... ee eee eee umask(2) 
file: determine filetype. ..........2.624-+.2.. file(1) 

file distribution program. . . 2... 2. eee ee eee rdist(1) 

file entry. /getfsspec, getfsfile, getfstype, ......... getfsent(3) 
file-entry., Petorent,. <2 Av lecise ist La a eS a ae ee wee a Le getgrent(3) 
file entry. getpwent, getpwuid, gettpwnam, ........ getpwent(3) 
fileentry. getttyent, . 2... 2. ee eee eee ee getttyent(3) 
file‘for.a‘pattern:, <3 seh. eS Eh A Se a Lee wed grep(1) 

file for reading or writing, or createanew file. ....... open(2) 
file-for:séendmails.: (20. $05, (Aces oe Ceca se on ie we aliases(5) 
file for transmission viamail. . ........ 2.2 eee uuencode(1C) 
file format. noe 5 oe Tee We Hae Ge Aste ie See Ee Gy AS, Se ar(5) 
filefOrMatin 4. iss Sle, oh hat eke se Bice ee ee oe eee tar(5) 

file including aliases and paths (csh only). ........-. which(1) 
fileinformation. ..... 2... 2 2 ee eee wens chfn(1) 
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chfn, chsh, passwd: change password 
chfn, chsh, passwd: change password 
uuxqt: UUCP execution 

fsplit: split a multi-routine Fortran 
split: split a 

pmerge: pascal 

mktemp: make a unique 

fseek, ftell: reposition a 

more, page: 

stat, Istat, fstat: get 

stat, Istat, fstat: get 

mkfs: construct a 

mkproto: construct a prototype 
mount, umount: mount or remove 
mount, umount: mount and dismount 
newfs: construct a new 

repquota: summarize quotas for a 
setquota: enable/disable quotas on a 
tunefs: tune up an existing 

repair. fsck: 

getfsfile, getfstype, setfsent, endfsent: get 
dcheck: 

dump: incremental 

rdump: 

trestore: restore a 

hier: 

dumpfs: dump 

quot: summarize 

quotacheck: 

quotaon, quotaoff: turn 

restore: incremental 

icheck: 

mtab: mounted 

fs, inode: format of 

utime: set 

utimes: set 

uusend: send a 

truncate: truncate a 

patch: a program for applying a diff 
ftp: ARPANET 

tftp: trivial 

ftpd: DARPA Internet 

tftpd: DARPA Trivial 

file: determine 

basename: strip 

glob: 

ferror, feof, clearerr, 

checknr: check nroff/troff 

cmp: compare two 

comm: select or reject lines common to two sorted 
config: build system configuration 
find: find 

split a multi-routine Fortran file into individual 
makedev: make system special 

mv: move or rename 

rmdir, rm: remove (unlink) directories or 
sort: sort or merge 

uulog: display UUCP log 

intro: introduction to special 
catman: create the cat 

fsync: synchronize a 

rm, rmdir: remove (unlink) 

uucico, uucpd: transfer 

badsect: create 

fstab: static information about the 
more, page: file perusal 

colcrt: 

col: 

plot: graphics 

refer: 

find: 


look: 

manual. man: 
ttyname, isatty, ttyslot: 
ttynam, isatty: 
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file-information:,.© c.g. dole: ces ce ee cade ee cae FR ee a chsh(1) 
file information 7.5.55" fee eas Go 0? Gates 8 so Se Se tan a Ma passwd(1) 
file interpreters >. s:rsts.usy oe Eas el es LG a eas BLA uuxqt(8C) 
file into individual files. . ..........6.222.4. fsplit(1) 
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file:Mergerss 14. gies el be bu tas UR Boe ea pmerge(1) 
file TAME: «..5- seats OR, Ac ale SGP A aD mktemp(3) 
fileonalogicalunit, 2... 1... 1. ee eee eee ee fseek(3F) 
file perusal filter for crt viewing. . ........-2-. more(1) 
ALE Stats, * sey hE OR Sec Ta ete Se” LE, Soy Meee ae LE ok ty ae stat(2) 
IE Status; 26 se) ee ha a EE a stat(3F) 
filesystems, «.o.05 Veneer As ee es Bee ie Se EE AE OS mkfs(8) 
filesystems.) is p0esie eS eres Ries Bre Ee oe Seles mkproto(8) 
file System: 26 46° se Fe el oe: Go Ses Ges Ee ae Ae Gea a SS mount(2) 
file-Systemi> 2 oe es OS we SE WS Es mount(8) 
fIIESYStENT:.) an Se eS co aes ee Wace eee Se ee newfs(8) 
file:syStemis © a. seo cas Sree Bi cd Patel ee ce ce ST SO ad repquota(8) 
file-Systemi> sone. ew. BE We ee ws ee setquota(2) 
file Systems. ns. .g2t is ese oe Se tae Bier Hite he we F tunefs(8) 
file system consistency check and interactive ........ fsck(8) 
file system descriptor file entry. /getfsspec, ........ getfsent(3) 
file system directory consistency check. . .......-. dcheck(8) 
filesystem dump. ........4.-650205028-+08- dump(8) 
file system dump across the network. . ......-..2.-.% rdump(8C) 
file system dump across the network. . ......-..-. rrestore(8C) 
filesystemhierarchy, . .......-.-202050-e +e eee hier(7) 
filesysteminformation, .........-6.6-6-2-02088 dumpfs(8) 
file system ownership. . . 2... 6. eee ee ee eee quot(8) 
file system quota consistency checker. . .. 2.2... quotacheck(8) 
file system quotas onandoff. .........6.-+.2-. quotaon(8) 
filesystemrestore. . 2... 7 ee eee ee ee eee restore(8) 
file system storage consistency check. ........2.-. icheck(8) 
filesystemtable. . 2... ee ee ee ee ee ee mtab(5) 
filesystem volume. ... 2... 2.6. 2 ee ee ee eee fs(5) 
Mle tIMeS ces aussi F pists. G3 ao dy! ite We etek ele ek a Ae utime(3C) 
TLCUIMESS . “s Sy oo Vek tsd Re Sesegs ta lds | Ss Sane RD Re Cae utimes(2) 
filetovasremote Hosts. «ig. “es eset Uses ek eB cat lee Ue ss Tes wee uusend(1C) 
filetoaspecifiedlength ...........2.2-+.2-. truncate(2) 
filetoanoriginad 1... 1... 2.5.22 e ee ee eee patch(1) 
filetransfer program. .... 2... 2 ee ee ee eee ftp(.C) 
filetransfer program. ..... 2.2.2 ee ee ee eee tftp(1C) 
File Transfer Protocol server. . 2... 6. 2 ee ee eee ftpd(8C) 
File Transfer Protocol server. . . 2... 6. ee ee eee tftpd(8C) 
file: tyPe.: 2s Sire. oh es WO wy a Bees Sa, RES SES, ee file(1) 
filename affixes; « ese oe. c8 Ge htuas Joe Biss Base eS oS basename(1) 
filename expand argumentlist. ..........228.2- csh(1) 
fileno: stream status inquiries. . ........6.2-+026-. ferror(3S) 
PLES :, fos ee sa es ee ad eit tae ds Seles ihre se eee Ae ORES, checknr(1) 
TLCS 3 Sera ee ten ce 88s US2 FFE, Sats ES Wed LT ey ch ag SR Tt Ta ae LE cmp(1) 
IES 2 204 70k 7S och ek Wy eee a Get er TS oP CLS Se Ee Le comm(1) 
MESH ss Ye Sd Ahh es tee ee A ets “eet SO SE ata hes OS config(8) 
ALES Sey ve See soy “eat ASS, WH Sak SL oak DY ow Sat ORS ves Get AE be Sh TS find(1) 
filés:-fsplit?> ce: Sook ar te Geiss DP AL We cad se ES Ae ete Be fsplit(1) 
FES. eine Ae, oh Ee ey Seah, See WR oe Ease S ow ce makedev(8) 
ALES esos ipa Bek ay cal AE, WE Sa ON Pease) oIEET Sok CDE UAE, bc SPSS mv(1) 
PLES se wesn sd Ree aca aah Se ge teeta ae TRG as Mince Sees rmdir(1) 
TCS = oe tap eS ner doe erie <a, Pe yee yee erie eho sort(1) 
PILES? =o Secs 3d, eats eta ai eae eee ea ee ae ye NRE uulog(1C) 
files and hardware support. . ... 2... 2.22 ee eee intro(4) 
filesforthe manual. . . 2... 2.7. ee ee ee eee catman(8) 
file’s in-core state with thaton disk. ..........-. fsync(2) 
files ordirectories. . 1... 1. ee ee ee ee ew eee rm(1) 
files queued by uucporuux. . 2... 2... eee eee uucico(8C) 
files to contain bad sectors. . . 1... 2 2 ee ee eee badsect(8) 
FILESYVStEMS.... Sy ca. Fe. te vst ep Fe Sete tae 18s we Verge GE. 1S? Re ceies fstab(5) 
filter-for'crt- Viewing. . aii ee ce eee a ae a a Le more(1) 
filter nroff output forCRT previewing. .......... colcrt(1) 
filter teversé line feéd&: wx a a ea a em we col(1) 
PUIGSTS 4. ~ PAL A, hy a SS kar oe Se ads Al toes CaP ae tee tat tat ek plot(1G) 
find and insert literature references in documents. ...... refer(1) 
fitid filess. ee Ser ey ae oh ae Rc 8 eh ee OD ae Bed find(1) 
fitid* find filess: sce sce ck aah Sa) eee es Sha et EA eek ae EE find(1) 
find lines inasortedlist. . 2... 6. ee ee ee eee look(1) 
find manual information by keywords; printoutthe ..... man(1) 
findname ofaterminal. ..........0.6.2.20e008-8 ttyname(3) 
findname of aterminal port. ..........4.+.2.. ttynam(3F) 
4.3BSD 


Permuted Index 


lorder: 

lookbib: build inverted index for a bibliography, 
spell, spellin, spellout: 

binary, file. strings: 


manipulations. copysign, drem, 

fold: fold long lines for 

plot: openpl et al.: {77 library interface to 
head: give 

dbminit, fetch, store, delete, 

fish: play ‘‘Go 


nice, nohup: run a command at low priority 


arff, 

extreme values. fimin, 

return extreme values. 

trpfpe, fpecnt: trap and repair 
trapov: trap and repair 

infnan: signals invalid 

file. 

and round-to-nearest functions. fabs, 
fabs, floor, ceil, rint: absolute value, 
arff, flcopy: archiver and copier for 
rx: DEC RX02 

rxformat: format 

fl: console 

fclose, fflush: close or 


flush: 

exit: terminate a process after 

/gcd, invert, rpow, msqrt, mcmp, move, min, omin, 
/memp, move, min, omin, fmin, m_in, mout, omout, 


device. 

fold: 

bugfiler: file bug reports in 

vwidth: make troff width table for a 
vfont: 


fg: bring job into 


idate, itime: return date or time in numerical 
dmesg: collect system diagnostic messages to 
ar: archive (library) file 

dump, dumpdates: incremental dump 

tar: tape archive file 

indent: indent and 

format: how to 

rxformat: 

htable: convert NIC standard 

gettable: get NIC 


vtroff, or troff. vip: 
uuencode: 

dir: 

fs, inode: 

core: 

tbl: 

tp: DEC/mag tape 

vfont: font 

scanf, fscanf, sscanf: 
printf, fprintf, sprintf: 
fmt: simple text 

bib, listrefs: bibliographic 
nroff: text 

troff, nroff: text 

ms: text 

me: macros for 

f77: 

ratfor: rational 

fpr: print 

fsplit: split a multi-routine 


4.3BSD 


- xli- 
find ordering relation for an object library. . . ....... lorder(1) 
find references in a bibliography. indxbib, ......... lookbib(1) 
find spellingerrors,. . 2... 2... ee ee ee ee ee spell(1) 
find the printable strings ina object, orother . ....... strings(1) 
finger: user information lookup program. ......... finger(1) 
fingerd: remote user information server. . ...... 2... fingerd(8C) 
finite, logb, scalb: copysign, remainder,exponent ...... ieee(3M) 
finite width output device. . . 1... 2... 22 ee eee fold(1) 
plot (3X) libraries. 2. 6 1 we ee ee ee ee plot(3F) 
firstfew Mines. es sd..38 3 se oe Et ee Ro head(1) 
firstkey, nextkey: data base subroutines. . .. 1... 2... dbm(3X) 
Fish 745 ict a) en oh Syst is A) ton ge ane n -A TE ete Oe, eo ge fish(6) 
fish: play ‘GoFish’. 2. 1 1 ww eee ee ee ee fish(6) 

(SH OMY). 6 lee 2 Seb ee Sc el ee Goh el Geese ie Bel ce ec er lee coe nice(1) 

fl: console floppy interface. . . 2... 1... 7 eee eee f1(4) 
flcopy: archiver and copier for floppy. .......... arff(8V) 
fimax, ffrac, dflmin, dflmax, dffrac,inmax:retun ...... flmin(3F) 
fimin, flmax, ffrac, dflmin, dflmax, dffrac,inmax: ...... flmin(3F) 
floating pointfaults; . ........26.6-62-006-. trpfpe(3F) 
floating pointoverflow. .. 2... 2. 2 eee eee ee trapov(3F) 
floating-point operations on a VAX (temporary), ...... infnan(3M) 
flock: apply or remove an advisory lock onanopen .... . flock(2) 
floor, ceil, rint: absolute value, floor, ceiling, ........ floor(3M) 
floor, ceiling, and round-to-nearest functions. ....... floor(3M) 
HOPPY ss 65 Sa, Geese hee Tod) on eee ee Bee Sse S ale FE arff(8V) 
floppy diskinterface. . . 1... 2... 2.2 ee ee eee rx(4) 
floppy disks)... © 2.3 shoei eS eae cele BE SS Re le OE rxformat(8V) 
floppyinterface. . . 2... 1... ee ee ee ee eee f1(4) 
fushsa-streamis so ss se ea a ce aoa ee i fe a a fclose(3S) 
flush: flush output toalogicalunit. . . 2... 2... ee ee flush(3F) 
flush output toalogicalunit. . 2... 1. ee ee ee flush(3F) 
flushing any pending output. .........2.-02-. exit(3) 
fmin, m_in, mout, omout, fmout, m_ out, sdiv,itom:/ ..... mp(3X) 
fmout, m_out, sdiv, itom: multiple precision) . ....... mp(3X) 
fmt: simple textformatter. . ........-262-+200. fmt(1) 
fold: fold long lines for finite width output ......... fold(1) 
fold long lines for finite width output device. . ....... fold(1) 
folders automatically, . 2... 1. 2 eee eee ee ee bugfiler(8) 
PONS 5, Soe we heres eee: SOME ee dye Te Te Ne ee da ed vwidth(1) 
font formats for the Benson-Varian or Versatec. ...... vfont(5) 
fopen, freopen, fdopen: openastreaam. .......... fopen(3S) 
foreach: loop over listofnames. . ........+2-. esh(1) 
Foreground: see ee vec ed wah Ee a ae wR EE esh(1) 
fork: create a copy of this process. . 1... 6. eee eee fork(3F) 
fork: create anew process. . . 2... eee ee ee eee fork(2) 
POLI: P75 eo, aad gee beta tec. gee Bev uete Be Ua wide Soh Wen ee Seed Nel WE idate(3F) 
form €1ror logy. eae aes we pw Ge a eee ee dmesg(8) 
TOLMAL,, 2-15 shes Sh Se ieee ees Sees ars ee eee es Aes ar(5) 
formats ovsrigs Beco ig OR St oe A ged BS ee gt a tae dump(5) 
LOTTA oak 25526 a ia Te Ge Le Got EE Te PLD AI OE Le tar(5) 
format C program source. . 2. 6 1 ee ee ee ee ee indent(1) 
format disk packs. . . 1... 1 ee ee ee ee eee format(8V) 
format floppy disks. . 2. 6. 1 ee ee ee ee ee rxformat(8V) 
formathosttables. . .... 2... 2 ee eee ewe e htable(8) 
format host tables fromahost. .........288- gettable(8C) 
format: how to format disk packs. ........-2-. format(8V) 
Format Lisp programs to be printed with nroff, ....... vip(1) 
format of an encoded uuencode file. ........4.24.4- uuencode(5) 
format of directories. . 2... 6. 2 ee ee ee ee ee dir(5) 
format of filesystem volume. . ........6.2-008-6- fs(5) 
format of memory image file. 2... 2... ee ee ee core(5) 
format tables for nroff ortroff. .........4.26- tbl(1) 
formatss:. co. 5 3.208 pe NE ed ee Pe Lew et oe ee tp(5) 
formats for the Benson-Varian or Versatec. .......-. vfont(5) 
formatted input conversion. ... 2... eee ee eee scanf(3S) 
formatted output conversion. .... 1... ee ee ee printf(3S) 
formatter: ¢s-4) Siete daha Ee, eee. Aas eRe. aU ae fmt(1) 
formatter; list bibliographic reference items. ........ bib(1) 
formatting,  <.2s pee le a eee ee eG nroff(1) 
formatting and typesetting, . .......-2.-0 2 eee troff(1) 
formatting macros. .. 1... 6 ee ee ee ee ee ms(7) 
formatting papers., 6-0. 6S ee we a we me(7) 
Fortran 77 compiler. . . 2... eee ee ee ee ee f77(1) 
Fortran‘dialect::: © <i. [ss Se ceecunk dee eg Base ee Eo es ratfor(1) 
BOftran file! epee ee st eter gcadeh Soh Meee eae So Ge ae ee a fpr(1) 
Fortran file into individual files. . ..........2.2. fsplit(1) 
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efl: Extended 

intro: introduction to 

putc, fputc: write a character to a 

struct: structure 

adage. 
login,/ sh, for, case, if, while, :, . 
exit, export,/ sh, for, case, if, while, : 

compiler/interpreter. 

trpfpe, 


printf, 

putc, putchar, 
putc, 

puts, 

ik: Ikonas 
liszt: compile a 


df: disk 

malloc, 

malloc, 

fopen, 

exponent. 

from: who is my mail 
sccs: 


scanf, 
mklost+found: make a lost+found directory for 
repair. 


individual files. 


stat, Istat, 
stat, Istat, 
on disk. 
fseek, 
fseek, 
time, 


shutdown: shut down part of a 

tn3270: 

lgamma: log gamma 
compiler/interpreter. fp: 

asinh, acosh, atanh: inverse hyperbolic 
bit: and, or, xor, not, rshift, Ishift bitwise 
erf, erfc: error 

value, floor, ceiling, and round-to-nearest 
intro: introduction to C library 

intro: introduction to FORTRAN library 
jO, j1, jn, yO, yl, yn: bessel 

math: introduction to mathematical library 
sinh, cosh, tanh: hyperbolic 

cos, tan, asin, acos, atan, atan2: trigonometric 
bessel 

curses: screen 

fread, 

aardvark: yet another exploration 
adventure: an exploration 

backgammon: the 

battlestar: a tropical adventure 

hunt: a multi-player multi-terminal 
monop: Monopoly 

snake, snscore: display chase 

trek: trekkie 

worm: Play the growing worm 

canfield, cfscores: the solitaire card 
cribbage: the card 

hangman: Computer version of the 
boggle: play the 

chess: the 

zork: the 

wump: the 

lgamma: log 

fmin, m_in, mout,/ madd, msub, mult, mdiv, pow, 
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FortranLanguage. . . 2... 1 ee ee ee ee ee efl(1) 
FORTRAN library functions. .........-2.26.- intro(3F) 
fortranlogicalunit. .. 1... 2... ee ee ee ee putc(3F) 
Fortran programs. . 2... 1 1 ee ee ee ee ee struct(1) 
fortune: print a random, hopefully interesting, ....... fortune(6) 
, break, continue, cd, eval, exec, exit,export, ........ sh(1) 
; » » break, continue, ed, eval, exec, 4 « as 6 @ be es sh(1) 
fp: Functional Programming language .........- fp(1) 
fpecnt: trap and repair floating point faults. ........ trpfpe(3F) 
fpr: print Fortran file. . 2... 1.2... 2 ee ee ee ee fpr(1) 
fprintf, sprintf: formatted output conversion. . ....... printf(3S) 
fputc, putw: put character or word onastreaam. ....... putc(3S) 
fputc: write a character to a fortran logicalunit. . ...... putc(3F) 
fputs: puta stringonastream. ... 2... ee ee eee puts(3S) 
frame buffer, graphics device interface. ..........- ik(4) 
Franz Lisp program. .. 2... ee ee ee ee ee we liszt(1) 
fread, fwrite: buffered binary input/output. . ........ fread(3S) 
ATEE> 95 %es 3 abies. Ses Gh te, Laies che nee seas Be jap ee SI8S em Le eS He df(1) 
free, falloc: memory allocator. ........6.-+e00- malloc(3F) 
free, realloc, calloc, alloca: memory allocator. ....... malloc(3) 
freopen, fdopen: openastream. ... 2... eee eee fopen(3S) 
frexp, ldexp, modf: splitintomantissaand ......... frexp(3) 
POM ae eo te ees, SB Me ecie ody ve Cte se et AE be oh TS from(1) 
front end for the SCCS subsystem. . .. 1... 2... 22s secs(1) 
fs, inode: format of filesystem volume. . ......... fs(5) 
fscanf, sscanf: formatted input conversion. . ........ scanf(3S) 
PSCli. soos? a Gee eh Sel a ane: RE OE aac We Oe mklost+found(8) 
fsck: file system consistency check andinteractive ..... fsck(8) 
fseek, ftell: reposition a fileonalogicalunit,. ........ fseek(3F) 
fseek, ftell, rewind: repositionastream. .......... fseek(3S) 
fsplit: split a multi-routine Fortran fileinto ......... fsplit(1) 
fstab: static information about the filesystems. ....... fstab(5) 
fstatiset file:status:. ss-r a Ai ces epee ee an a Bee d stat(2) 
fstat: get filestatus. 2 6. 1 ee ee ee ee ee stat(3F) 
fsync: synchronize a file’s in-core state withthat ...... fsync(2) 
ftell: reposition a fileonalogical unit. .......... fseek(3F) 
ftell, rewind: repositionastream. .........4.2.6. fseek(3S) 
ftime: get dateandtime. . .......-2 2. eee eee time(3C) 
ftp: ARPANET file transfer program. . ........2.2. ftp(1C) 
ftpd: DARPA Internet File Transfer Protocol server. . . . . . ftpd(8C) 
full-duplex connection. . 2... ...-..54 2.42 eee shutdown(2) 
full-screen remote logintoIBM VM/CMS. ........ tn3270(1) 
PUNICHON:. we si Soe ee ee elisa Sa He eS eal Se lgamma(3M) 
Functional Programming language .........-2.e. fp(1) 
FUuNCHONS 2) iF Hs) ee idence te Boe cee ee Ss de a we asinh(3M) 
FWNCHONS S m's= 3. sete bo ee deh ee a Gees lee ee Se te ee ere vee Se bit@F) 
AUNCHONS:.- 6-5 ass so Beier ee ot YS SI ek res es erf(3M) 
functions. fabs, floor, ceil, rint: absolute .......4.. floor(3M) 
FUNCHONS:: yer ee cacig, ae ae Mey CEMA Law ter gh Mee cae sl a cal intro(3) 
FUNCHONS ys ge 25> 25, 59 Shy Ge Ue at Geb Ske a OA Ge te intro(3F) 
functions:, S42. seta tee, ao ea ee ss es She ite ee eS jO(3M) 
AUNCHONSS: ad sos we FE Sak I Se OS TR Le A SO math(3M) 
FUNCHONS 2h es Zh oS he ee ae de RDS de eg et OP Gen a sinh(3M) 
functions and their inverses. sin, ........-+e.e. sin(3M) 
functions: of two kinds for integer orders. ......... bessel(3F) 
functions with ‘‘optimal’’ cursor motion. ......... curses(3X) 
fwrite: buffered binary input/output. .........2.2. fread(3S) 
DAMIGS ~ vere Gs. weirs cles ely Welslera son inCane's ats a eat Oey fe a-ak aardvark(6) 
AME, ecard lee Sh SE Woe ha Solas Setar ers “Settee Spee Hen ee alae See i adventure(6) 
PAM xed 8 eka Ge wee MS LO ae eee eS Le a aie Gn a Ve La backgammon(6) 
AME ewe te. ee te Oe eS eh Behe late Sa ae OW. Ce a battlestar(6) 
GAMES .” vss ez vey heady a let an My Sees Se Wt weep eto Wate Te cee hunt(6) 
PAM ese eos eee ee a See ae? Gee SE ee a monop(6) 
AMCs 85S set ee ae te ae ete OE ie ey ADS snake(6) 
PAM.” asst ey corias tea WSY alee castes tae WSs ser Cesta ha WI", fee cess trek(6) 
DANG: - alin 8d woe se Uae bene he Ube Gee A> Sk SEL ae ate AE Sg worm(6) 
game canfield.. 00. a: 3: ee We ess SR canfield(6) 
pamecribbage. “soos Aids oe 6h et yield e A cribbage(6) 
Pame hangman, ae). “ax sé: cee ie Sees ee ce ak OS See ee sak hangman(6) 
Game:of boggles 4. siisr. a ce 4 Wo ROR eR Bt ee ee boggle(6) 
Pame.of CHESS srs Seis Sos. fos ee we a, Se Ss A chess(6) 
game ofdungeon. 2... 1... eee ee ee ee eee zork(6) 
game of hunt-the-wumpus. .........-52. ee ee wump(6) 
gamma function. . 2... 1 ee ee ee ee ee ee lgamma(3M) 
gcd, invert, rpow, msqrt, mcmp, move, min,omin, ..... mp(3X) 
gcore: get core images of running processes. ........ gcore(1) 
4.3BSD 


Permuted Index 


ecvt, fevt, 

buffers. kgmon: 

abort: 

makekey: 

mkhosts: 

mkpasswd: 

Iptest: 

ncheck: 

rand, srand: random number 

random, drandm, irandm: better random number 
lex: 

/srandom, initstate, setstate: better random number 
random number generator; routines for changing 
perror, 


from stream. 
stream. getc, 


getgid, 


getuid, 

setfsent, endfsent: get file system descriptor/ 
system descriptor file entry. getfsent, getfsspec, 
endfsent: get file system descriptor/ getfsent, 
descriptor file/ getfsent, getfsspec, getfsfile, 
getuid, 


get group file entry. 
file entry. getgrent, 
getgrent, getergid, 


get network host entry. gethostbyname, 
sethostent, endhostent: get network host entry. 
host entry. gethostbyname, gethostbyaddr, 
current host. 

host. 

timer. 


get network entry. getnetent, 
entry. getnetent, getnetbyaddr, 
endnetent: get network entry. 


getpid, 

scheduling priority. 

protocol entry. getprotoent, getprotobynumber, 
endprotoent: get protocol entry. getprotoent, 
setprotoent, endprotoent: get protocol entry. 


setpwfile: get password file entry. 
password file entry. getpwent, getpwuid, 
get password file entry. getpwent, 
resource consumption. 

utilization. 


entry. getservent, getservbyport, 
endservent: get service entry. getservent, 
setservent, endservent: get service entry. 
gettimeofday, settimeofday: 
gethostname, sethostname: 

getpriority, setpriority: 

gethostid, sethostid: 

getitimer, setitimer: 


sockets. 
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gcvt: output conversion. : 
generate a dump of the operating gyaten’ s ‘profile 
generate a fault. 

generate encryption key. 

generate hashed host table. 

generate hashed password table. 

generate lineprinter ripple pattern. 

generate names from i-numbers. 

generator. 

generator. 

generator of lexical sali Geopr programs. 

generator; routines for changing generators. 
generators. /srandom, initstate, setstate: better 
gerror, ierrno: get system error messages. 

getarg, iargc: return command line arguments. 
getc, fgetc: get a character from a logical unit. 
getc, getchar, fgetc, getw: get character or word 
getchar, fgetc, getw: get character or word from 
getcwd: get pathname of current working directory. 
getdiskbyname: get disk description by its name. 
getdtablesize: get descriptor table size. 

getegid: get group identity. 

getenv: get value of environment vacaples 
getenv: value for environment name. 

geteuid: get user identity. ‘ 
getfsent, getfsspec, getfsfile, getfstype, 

getfsfile, getfstype, setfsent, endfsent: get file 
getfsspec, getfsfile, getfstype, setfsent, 

getfstype, setfsent, endfsent: get file system 
getgid: get user or group ID of the caller. 

getgid, getegid: get group identity. 

getgrent, getgrgid, getgrnam, setgrent, ennleront 
getgrgid, getgrnam, setgrent, endgrent: get group 
getgrnam, setgrent, endgrent: get group file entry. 
getgroups: get group access list. 

gethostbyaddr, gethostent, sethostent, enulhostenty 
gethostbyname, gethostbyaddr, gethostent, 
gethostent, sethostent, endhostent: get network 
gethostid, sethostid: get/set unique identifier of 
gethostname, sethostname: get/set name of current 
getitimer, setitimer: get/set value of interval 
getlog: get user’s login name. 

getlogin: get login name. é 
getnetbyaddr, getnetbyname, semipient eaidnetent! 
getnetbyname, setnetent, endnetent: get network 
getnetent, getnetbyaddr, getnetbyname, setnetent, 
getopt: get option letter from argv. 

getpagesize: get system page size. 

getpass: read a password. 

getpeername: get name of connected peer. 
getpgrp: get process group. 

getpid: get process id. 

getpid, getppid: get process idenufication;, 
getppid: get process identification. 

getpriority, setpriority: get/set program 
getprotobyname, setprotoent, endprotoent: get 
getprotobynumber, getprotobyname, setprotoent, 
getprotoent, getprotobynumber, getprotobyname, 
getpw: get name from uid. 


getpwent, getpwuid, getpwnam, serpent endpwenk 


getpwnam, setpwent, endpwent, setpwfile: get 


getpwuid, getpwnam, setpwent, endpwent, setpwfile: 


getrlimit, setrlimit: control maximum system 
getrusage: get information about resource 

gets, fgets: get a string from a stream. te 
getservbyname, setservent, endservent: get service 
getservbyport, getservbyname, setservent, 
getservent, getservbyport, getservbyname, 

get/set date and time. 

get/set name of current host. 

get/set program scheduling priority. 

get/set unique identifier of current host. 

get/set value of interval timer. 

getsockname: get socket name. 

getsockopt, setsockopt: get and set boron on 
gettable: get NIC format host tables from a host. 
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ecvt(3) 
kgmon(8) 
abort(3) 
makekey(8) 
mkhosts(8) 
mkpasswd(8) 
Iptest(1) 
ncheck(8) 
rand(3C) 
random(3F) 
lex(1) 
random(3) 
random(3) 
perror(3F) 
getarg(3F) 
getc(3F) 
getc(3S) 
getc(3S) 
getcwd(3F) 
getdisk(3) 
getdtablesize(2) 
getgid(2) 
getenv(3F) 
getenv(3) 
getuid(2) 
getfsent(3) 
getfsent(3) 
getfsent(3) 
getfsent(3) 
getuid(3F) 
getgid(2) 
getgrent(3) 
getgrent(3) 
getgrent(3) 
getgroups(2) 


gethostbyname(3N) 
gethostbyname(3N) 
gethostbyname(3N) 


gethostid(2) 
gethostname(2) 
getitimer(2) 
getlog(3F) 
getlogin(3) 
getnetent(3N) 
getnetent(3N) 
getnetent(3N) 
getopt(3) 
getpagesize(2) 
getpass(3) 
getpeername(2) 
getpgrp(2) 
getpid(3F) 
getpid(2) 
getpid(2) 
getpriority(2) 
getprotoent(3N) 
getprotoent(3N) 
getprotoent(3N) 
getpw(3C) 
getpwent(3) 
getpwent(3) 
getpwent(3) 
getrlimit(2) 
getrusage(2) 
gets(3S) 
getservent(3N) 
getservent(3N) 
getservent(3N) 
gettimeofday(2) 
gethostname(2) 
getpriority(2) 
gethostid(2) 
getitimer(2) 
getsockname(2) 
getsockopt(2) 
gettable(8C) 
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ttys file entry. 
entry. getttyent, 


user shells. 
getc, getchar, fgetc, 


head: 
shutdown: close down the system at a 


ASCII. ctime, localtime, 
time, ctime, Itime, 

fish: play 

setjmp, longjmp: non-local 


graph: draw a 


gprof: display call 

ik: Ikonas frame buffer, 

ps: Evans and Sutherland Picture System 2 
plot: 

arc, move, cont, point, linemod, space, closepl: 
plot: 

1ib2648: subroutines for the HP 2648 


verind: 

chgrp: change 

getpgrp: get process 

killpg: send signal to a process 

setpgrp: set process 

getgroups: get 

initgroups: initialize 

setgroups: set 

group: 

getgrgid, getgrnam, setgrent, endgrent: get 


setregid: set real and effective 

setruid, setgid, setegid, setrgid: set user and 
getuid, getgid: get user or 

getgid, getegid: get 

groups: show 

chown: change owner and 

make: maintain program 


worm: Play the 

stty, 

stop: 

reboot: reboot system or 


rmail: 
mh: Message 


re_comp, re_exec: regular expression 
hangman: Computer version of the game 
vhangup: virtually 

nohup: run command immune to 

crash: what 

link: make a 


intro: introduction to special files and 
rehash: recompute command 

unhash: discard command 

mkhosts: generate 

mkpasswd: generate 

hashstat: print command 


leave: remind you when you 
od: octal, decimal, 


hier: file system 
history: print 
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gettimeofday, settimeofday: get/set dateandtime. ...... gettimeofday(2) 
getttyent, getttynam, setttyent,endttyent: get ........ getttyent(3) 
getttynam, setttyent, endttyent: get ttysfile ......... getttyent(3) 
getty: setterminal mode. . .......-2. 6.522 e eee getty(8) 
gettytab: terminal configuration database. ......... gettytab(5) 
getuid, geteuid: getuseridentity. ............ getuid(2) 
getuid, getgid: get user or group IDofthecaller. ...... getuid(3F) 
getusershell, setusershell, endusershell: getlegal . ..... getusershell(3) 
getw: get character or wordfromstream. ......... getc(3S) 
getwd: get current working directory pathname. ....... getwd(3) 
give first few lines... s¢ 0. 3- ese ee ee ee we head(1) 
BIVED AME, ps. US Sener Sc eee SE ee ER sy a shutdown(8) 
glob: filename expand argumentlist. ........... csh(1) 
gmtime, asctime, timezone: convert dateandtimeto ..... ctime(3) 
gmtime:returnsystemtime. .........-++020- time(3F) 
CIO ISH A, 25552 Aeclh Ga lek ght etyss deve 'sy garst 8s oe. GS pehh ee S fish(6) 
BOLO se ods ance cd Hyd! oe Sani phen Wad 18 ee ip coi Shy WS? pF Ts Cee setjmp(3) 
goto: commandtransfer. ..........6-56-e-+00e- esh(1) 
gprof: display call graph profiledata. ........... gprof(1) 
LAPNss iss 25. pcos STE a Yor reich Soe Cote Tes $e fer Ca ck Masa tex Tepes os graph(1G) 
graph: drawagraphe 2... 1 we ee ee ee ee ee graph(1G) 
graph profiledataa ... 1... 2 ee ee ee ee we gprof(1) 
graphics device interface. .. 2... 2... eee eee ik(4) 
graphics device interface. .. 2... 2.2 ee ee ee ee ps(4) 
graphics filters, 9. 2 2 we ee ee ee ee ee ee plot(1G) 
graphics interface. /erase, label, line, circle, ........ plot(3X) 
graphicsinterface. 2. 2. 1 ee ee ee ee ee ee ee plot(5) 
graphicsterminal. 2... 1 1 wee ee ee ee ee ee 1ib2648(3X) 
grep, egrep, fgrep: searcha file forapatten. . ....... grep(1) 
grind nice listings of programs. . ........-0080- verind(1) 
OTOUPs> se eae oee bo SS we Sat ae SG Eades Ga ae “SL ad chgrp(1) 
PLOUP sc ee He. 8 EOE a RO te eae ee ae getpgrp(2) 
OTOUPs. rds og ep cob tS TSA ae Se co tS 8s ts “ea STs Sy ced killpg(2) 
STOUP. aid Bice a Bs Bee Se eee ee ww eS setpgrp(2) 
PTOUP-ACCESSHSbx - eo Seis. gS woo wie Me eee eet eA getgroups(2) 
SToUp acCess ists ous ca iss ve Re eve taste! Gere Gta Se Be ce initgroups(3) 
PTOUP ACCESS ISE:, <5.) ak Me wee 6h Lathe a Ce ea a setgroups(2) 
‘OTOUP TIES. - © sais Biss oes ee Be ELE RUE ites. SANS group(5) 
group fileentry. getgrent, . . 2... 2... eee eee getgrent(3) 
group: groupfile. . 2... we ee ee ee ee ee group(5) 
PTOUP-ID: 4 3 see Bee ge Sw, Me BREE SP eS Rise Sw a oe setregid(2) 
group ID. setuid,seteuid, . ........2.62-+2--. setuid(3) 
groupIDofthecaller. 2... 2... ee ee ee ee ee getuid(3F) 
groupidentity. 2... 2. ee eee ee ee ee ee getgid(2) 
groupmemberships. ...... 2-6-2. e eee eee groups(1) 
eroup Of afiles se eos ed veh es Se eee ae we ae ne ea chown(2) 
TOUS: a5 e SF ge nS ie wo Sa te ee Te make(1) 
groups: show group memberships. .........+.2-. groups(1) 
growing worm game. .. 2... 6 ee eee ee eee worm(6) 
gtty: set and get terminal state (defunct). ......... stty(3C) 
haltajoborprocess. . . 2... 6 ee eee ee ee ee csh(1) 
halt processors: ss. ke bey ese Pe Rw ew OS reboot(2) 
halt: stop the processor. . 2... 6 ee ee ee ee eee halt(8) 
handle remote mail received viauucp. .......+.+.-. rmail(1) 
12 E116 (ot re ne ee an an ee mh(1) 
Matidlers = 5. so: Seesaw oe ee do RE ee SS regex(3) 
HangmMane, ces 8 eines Sw ee ee ae SE se, ed ele al ae hangman(6) 
hangman: Computer version of the game hangman. .... . hangman(6) 
“‘hangup’’ the current control terminal. . ......... vhangup(2) 
aMSUpSs: cd Seg ce Bowe cs a ES Gas ie oa eS La os csh(1) 
happens when the systemcrashes. . . 2... 2... ee ee crash(8V) 
hardlinktoafilee 1... 1... 2. ee ww eee ewan link(2) 
hardware support. .. 1... 2. 2 ee ee ee ee ee intro(4) 
hash tables s 4.24) 3 -a.%.: daao Al itis te ete ee eke esh(1) 
hash:tablez. °° 4.23. d&. caviss 4 Gy costes tan iss | Ve ae de SD eRe ces esh(1) 
hashed host tables. « 2s. te se cst uote tex Me oe es la Sa aa Te wee Se mkhosts(8) 
hashed password table. . .. 2... ee eee eee mkpasswd(8) 
hashing:statistics: 9. esc a ew a ww esh(1) 
hashstat: print command hashing statistics. . ....... csh(1) 
have-toleaves, «Give Soe Fe hese oe ee Geom oe es leave(1) 
hdh: ACC IF-11/HDH IMPinterface. ........... hdh(4) 
hex, asciidlmp,. 52-66 wo ee we we a od(1) 
hier: file systemhierarchy. . .......2..6-6-2-0200 hier(7) 
HierarChyi.5 a Se Oe te peas ev aes Pew BS eS es hier(7) 
history-event list) <5. cs-meos. deb Se. eee el ae ee ee ae esh(1) 
history: print history event list. ..........+.2.. csh(1) 
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fortune: print a random, 

sethostid: get/set unique identifier of current 
gethostname, sethostname: get/set name of current 
gettable: get NIC format host tables from a 
hostnm: get name of current 

uusend: send a file to a remote 

htonl, htons, ntohl, ntohs: convert values between 
L.sys: UUCP remote 

remote: remote 

gethostent, sethostent, endhostent: get network 
hosts: 

phones: remote 

ruptime: show 

hostid: set or print identifier of current 

hostname: set or print name of current 

mkhosts: generate hashed 

htable: convert NIC standard format 

gettable: get NIC format 

system. 

L.aliases: UUCP 


ping: send ICMP ECHO_REQUEST packets to network 
uuname: list names of UUCP 


uptime: show 
format: 
1ib2648: subroutines for the 


interface. 


host and network byte order. 
and network byte order. htonl, 


wump: the game of 


asinh, acosh, atanh: inverse 

sinh, cosh, tanh: 

hy: Network Systems 

value. 

vacation: return 

getarg, 

mset: retrieve ASCII to 

map3270: database for mapping ascii keystrokes into 
tn3270: full-screen remote login to 


ping: send 


getpid: get process 

setregid: set real and effective group 
setgid, setegid, setrgid: set user and group 
whoami: print effective current user 
getuid, getgid: get user or group 

su: substitute user 

form. 

getpid, getppid: get process 
gethostid, sethostid: get/set unique 
hostid: set or print 

getgid, getegid: get group 

getuid, geteuid: get user 


setreuid: set real and effective user 
perror, gerror, 


biff: be notified 
eval, exec, exit, export, login,/ sh, for, case, 
hdh: ACC 


unifdef: remove 
uu: TUS8/DECtape 


ik: 


core: format of memory 
gcore: get core 
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hk: RK6-11/RK06 and RKO7 moving head disk. 
hopefully interesting, adage. 
host. gethostid, 
host. 


host. 
host and network byte order. 
host description file. 
host description file. 
host entry. gethostbyname, gethostbyaddr, 
host name data base. 
host phone number data base. 
host status of local machines. 
host system. 
host system. 
host table. 
host tables. 
host tables from a host. 
hostid: set or print identifier of current host 
hostname alias file. 
hostname: set or print name of current host system. 
hostnm: get name of current host. 
hosts. 
hosts. 
hosts: host name data base. 
how long system has been up. 
how to format disk packs. 

HP 2648 graphics terminal. 
hp: MASSBUS disk interface. 
ht: TM-03/TE-16,TU-45,TU-77 MASSBUS magtape 
htable: convert NIC standard format host tables. 
htonl, htons, ntohl, ntohs: convert values between 
htons, ntohl, ntohs: convert values between host 
hunt: a multi-player multi-terminal game. 
hunt-the-wumpus. 
hy: Network Systems Hyperchannel interface. 
hyperbolic functions. 
hyperbolic functions. 
Hyperchannel interface. 
hypot, cabs: Euclidean distance, complex absolute 
“‘T am on vacation’’ indication. 
iargc: return command line arguments. 
IBM 3270 keyboard map. 
IBM 3270 keys. 
IBM VM/CMS. 
icheck: file system storage consistency check. 
ICMP ECHO_REQUEST packets to network hosts. 
icmp: Internet Control Message Protocol. 
Ass ¥ .6oReal eos sai 1S hs aN te ae ALD voA ae tan oP SUL ee cohiah "eae ar Le 
ID. 
ID. setuid, seteuid, setruid, 
id. 
ID of the caller. 
id temporarily. 
idate, itime: return date or time in numerical 
identification. 
identifier of current host. 
identifier of current host system. 
identity. 
identity. 
idp: Xerox Internet Datagram Protocol. 
ID’s. 
ierrno: get system error messages. 
if: conditional statement. 
if mail arrives and who it is from. 

if, while, :, . , break, continue, cd, 
IF-11/HDH IMP interface. 
ifconfig: configure network interface parameters. 
ifdef’ed lines. 
Il UNIBUS cassette interface. 
ik: Ikonas frame buffer, graphics device interface. 
Ikonas frame buffer, graphics device interface. 

il: Interlan NI1010 10 Mb/s Ethernet interface. 
image file. 
images of running processes. 
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hk(4) 
fortune(6) 
gethostid(2) 
gethostname(2) 
gettable(8C) 
hostnm(3F) 
uusend(1C) 
byteorder(3N) 
L.sys(5) 
remote(5) 
gethostbyname(3N) 
hosts(5) 
phones(5) 
ruptime(1C) 
hostid(1) 
hostname(1) 
mkhosts(8) 
htable(8) 
gettable(8C) 
hostid(1) 
L.aliases(5) 
hostname(1) 
hostnm(3F) 
ping(8) 
uuname(1C) 
hosts(5) 
uptime(1) 
format(8V) 
1ib2648(3X) 
hp(4) 

ht(4) 
htable(8) 
byteorder(3N) 
byteorder(3N) 
hunt(6) 
wump(6) 
hy(4) 
asinh(3M) 
sinh(3M) 
hy(4) 
hypot(3M) 
vacation(1) 
getarg(3F) 
mset(1) 
map3270(5) 
tn3270(1) 
icheck(8) 
ping(8) 
icmp(4P) 
getpid(3F) 
setregid(2) 
setuid(3) 
whoami(1) 
getuid(3F) 
su(1) 
idate(3F) 
getpid(2) 
gethostid(2) 
hostid(1) 
getgid(2) 
getuid(2) 
idp(4P) 
setreuid(2) 
perror(3F) 
csh(1) 
biff(1) 

sh(1) 

hdh(4) 
ifconfig(8C) 
unifdef(1) 
uu(4) 

ik(4) 

ik(4) 

il(4) 

core(5) 
gcore(1) 
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notify: request 
nohup: run command 


acc: ACC LH/DH 

css: DEC IMP-11A LH/DH 

ddn: DDN Standard Mode X.25 

hdh: ACC IF-11/HDH 

implog: 

implogd: 

imp: 

css: DEC 

xstr: extract strings from C programs to 


which: locate a program file 
fsync: synchronize a file’s 
dump, dumpdates: 

dump: 

restore: 

indent: 


tgetnum, tgetflag, tgetstr, tgoto, tputs: terminal 
ptx: permuted 
L-dialcodes: UUCP phone number 


bibliography. indxbib, lookbib: build inverted 
objects. 

strncat, stremp, strncmp, strcpy, strncpy, strlen, 
last: 

vacation: return ‘‘I am on vacation’’ 

syscall: 


fsplit: split a multi-routine Fortran file into 
bibliography, find references in a bibliography. 


inet_Inaof, inet_netof: Internet address/ 


inet_addr, inet_network, inet_ntoa, inet_makeaddr, 
address/ inet_addr, inet_network, inet_ntoa, 
/inet_network, inet_ntoa, inet_makeaddr, inet_Inaof, 
inet_netof: Internet address/ inet_addr, 
Internet address/ inet_addr, inet_network, 

on a VAX (temporary). 

bad144: read/write dec standard 144 bad sector 
chfn, chsh, passwd: change password file 

chfn, chsh, passwd: change password file 

dbx: dbx symbol table 

dumpfs: dump file system 

pac: printer/plotter accounting 

chfn, chsh, passwd: change password file 
getrusage: get 

vtimes: get 

fstab: static 

man: find manual 

finger: user 

miscellaneous: miscellaneous useful 
XNSrouted: NS Routing 

fingerd: remote user 


init: process control 

ioinit: change f77 I/O 

tset: terminal dependent 

ttys: terminal 

initgroups: 

connect: 

popen, pclose: 

generator; routines for changing/ random, srandom, 
fimin, fimax, ffrac, dflmin, dfimax, dffrac, 
clri: clear 

fs, 

read, readv: read 

soelim: eliminate .so’s from nroff 

scanf, fscanf, sscanf: formatted 

ungetc: push character back into 

fread, fwrite: buffered binary 

stdio: standard buffered 
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immediate notification. ........6.2-0+050e5280- esh(1) 
immune tohangups. ....... +e. eee ee ee csh(1) 
imp: 1822 network interface. . 2... 2. 1 eee ee ee imp(4) 
imp: IMP raw socket interface. . ......-2-2- eee imp(4P) 
IMP interfaces sg. ako an te ase bette tek Mee, BS ta Dee Soh Se ee Se acc(4) 
INIPIGteriCe.. a) oe a cde eo ab ete a oe Ae ee es ae aS css(4) 
IMP:interfaces %s ro! 30. da os eed, Gl Sea aS. Ay ts ddn(4) 
IMP-interface:* 25: x3 oo: hu Se sere ved cen te a BS te & ee hdh(4) 
IMP loginterpreter. . 2... 2... 7. ee ee ee eee implog(8C) 
IMP logger process. =. «6 eee ee ee ee ee implogd(8C) 
IMP raw socketinterface. . . 1... 6. 2 2 ee ee eee imp(4P) 
IMP-11A LH/DHIMPinterface. ..........24.6- css(4) 
implement shared strings. .......-4.-02 ee ee xstr(1) 
implog: IMP loginterpreter. ..........24-+2.. implog(8C) 
implogd: IMP logger process. . . 2... 2... eee eee implogd(8C) 
including aliases and paths (csh only), .......+.2.. which(1) 
in-core state with thatondisk. ...........2.6. fsync(2) 
incremental dump format. ...........+.2e+.-. dump(5) 
incremental filesystem dump. ..........+.+e+.-. dump(8) 
incremental filesystemrestore. .......+.-+.-2e+.- restore(8) 
indent and format C program source. . . 2... 2... eee indent(1) 
indent: indent and format C program source. ........ indent(1) 
independent operation routines. tgetent, ......... termcap(3X) 
MDEK ere sak SOG a ree US tae Lacie A Ce og tae ee) a le “Soha Be ptx(1) 
Index'files xs) SWE Be ales rg ae eR ae GS, Mase Sal oe L-dialcodes(5) 
index for a bibliography, findreferencesina ........ lookbib(1) 
index, rindex, Inblnk, len: tell about character ....... index(3F) 
index, rindex: string operations. streat, .........- string(3) 
indicate last logins of users and teletypes. ......... last(1) 
INGICALON. Sse 62 eRe ece. ee ee He ae id es GER RA EE Si vacation(1) 
indirect systemcall, . 2. 1. 2 ee ee ee ee ee ee syscall(2) 
individual files. . . 1... 6 1 ee eee ee ee ee fsplit(1) 
indxbib, lookbib: build inverted index fora ........ lookbib(1) 
inet: Internet protocol family. ..........4.+... inet(4F) 
inet_addr, inet_network, inet_ntoa,inet makeaddr, ..... inet(3N) 
inetd: internet ‘‘super-server’. .......-6-2-+2e04 inetd(8) 
inet_Inaof, inet_netof: Internet address/\  . . . 2... ee ee inet(3N) 
inet_makeaddr, inet _Inaof,inet_netof:Internet ....... inet(3N) 
inet_netof: Internet address manipulation routines. ..... inet(3N) 
inet_network, inet_ntoa, inet_makeaddr, inet Inaof, .... . inet(3N) 
inet_ntoa, inet_makeaddr, inet Inaof,inet netof: ...... inet(3N) 
infnan: signals invalid floating-point operations ....... infnan(3M) 
INPOTMALION:, 25-5 25.555 ces eases mle se, Me aa ae SK bad144(8) 
INfOTMAHONS cops. (Fe Se S's ee oo oes Ge ORL ae Ea te os chfn(1) 
MfOrMAON:. [op e5 oS Se uns Fee eg Bw ee eS ee chsh(1) 
INTOTMALOMNs,” 255 <6 5 be Sek Sot Meier Se Ua see Ao eee So ee ae Se dbx(5) 
IMPOrMALON.. 5-52 26S sees AS oes Se SSR Mee RS dumpfs(8) 
INfOTMALIONS. oe eee ee ead ees eee eS Oe oe pac(8) 
INfOPMALON: <<. coy cd ceeds VF Geto ipa seo Wal VF Gee Se ce CRS ve See passwd(1) 
information about resource utilization, .........-. getrusage(2) 
information about resource utilization. .........-. vtimes(3C) 
information about the filesystems. .........4.2.-. fstab(5) 
information by keywords; print out the manual. . ...... man(1) 
information lookup program. . .... 2... ee ee ee finger(1) 
information pages. . . 6. 6 1 ee ee ee ee ee intro(7) 
Information Protocoldaemon. .........+.+-+.-. XNSrouted(8C) 
information server. . . 1... 6 ee ew ew ee ee ewe fingerd(8C) 
init: process control initialization. ............ init(8) 
initgroups: initialize group access list. . ... 2... 22. initgroups(3) 
InitialiZatiOMy: ay see a ee Se LE Sa cele eae “Sa ae init(8) 
Initialization: © see. See Re te ee SEE le a ee ioinit(3F) 
IitAliZAtOMS es 5 es OS Se. ck tae Sh ve “eee le Mave Te eed tset(1) 
initialization data. .... 2.2... ee ee ee ee ee ttys(5) 
initialize group access list. 2. 2 1. ee ee ee ee ee initgroups(3) 
initiate aconnectiononasocket. .......4.4.4268- connect(2) 
initiate I/O to/from a process. . 2... 1 ee ee ee ee popen(3) 
initstate, setstate: betterrandomnumber .........-. random(3) 
inmax: return extreme values. . . 2... 6. ee ee eee fimin(3F) 
INOUE + Ay Te So eB k Ae te oe Ee tek hy Te ce aL at he tee ek ee clri(8) 
inode: format of filesystem volume. ..........- fs(5) 
APU ah ci Soy TS Shae Rts ok GS easton ea. Tor ibs ae hs oo Sets 0 Gs read(2) 
INPUly) 488 we, Se a a ses, REGS ae soelim(1) 
inputconversion. . . 2... ee ee ee ee ee scanf(3S) 
input stream. 6 6 1 ww ee ee eee ungetc(3S) 
input/output. seca deh eo ee eee ge) et te Ge es eed de es fread(3S) 
input/output package. . 2. 6 1 eee ee ee ee ee stdio(3S) 
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ferror, feof, clearerr, fileno: stream status 
refer: find and 
insque, remque: 


install: 


learn: computer aided 

doctor: 

jove: an 

fsck: file system consistency check and 
fortune: print a random, hopefully 

acc: ACC LH/DH IMP 

cons: VAX-11 console 

crl: VAX 8600 console RLO2 

css: DEC IMP-11A LH/DH IMP 

ct: phototypesetter 

ddn: DDN Standard Mode X.25 IMP 
de: DEC DEUNA 10 Mb/s Ethernet 

dn: DN-11 autocall unit 

ec: 3Com 10 Mb/s Ethernet 

en: Xerox 3 Mb/s Ethernet 

ex: Excelan 10 Mb/s Ethernet 

fl: console floppy 

hdh: ACC IF-11/HDH IMP 

hp: MASSBUS disk 

ht: TM-03/TE-16,TU-45,TU-77 MASSBUS magtape 
hy: Network Systems Hyperchannel 

ik: Ikonas frame buffer, graphics device 
il: Interlan NI1010 10 Mb/s Ethernet 
imp: 1822 network 

imp: IMP raw socket 

ix: Interlan Np100 10 Mb/s Ethernet 

lo: software loopback network 

mt: TM78/TU-78 MASSBUS magtape 
mtio: UNIX magtape 

np: Interlan Np100 10 Mb/s Ethernet 
pel: DEC CSS PCL-11 B Network 
cont, point, linemod, space, closepl: graphics 
plot: graphics 

and Sutherland Picture System 2 graphics device 
qe: DEC DEQNA Q-bus 10 Mb/s Ethernet 
rx: DEC RX02 floppy disk 

tm: TM-11/TE-10 magtape 

tmscp: DEC TMSCP magtape 

ts: TS-11 magtape 

tty: general terminal 

tu: VAX-11/730 and VAX-11/750 TUS58 console cassette 
uda: UDA-50 disk controller 

ut: UNIBUS TU45 tri-density tape drive 
uu: TU5S8/DECtape II UNIBUS cassette 
va: Benson-Varian 

vp: Versatec 

nsip: software network 

ifconfig: configure network 

plot: openpl et al.: £77 library 

telnet: user 

slattach: attach serial lines as network 

il: 

ix: 

np: 

swapon: add a swap device for 
sendmail: send mail over the 

/inet_ntoa, inet_makeaddr, inet_Inaof, inet_netof: 
icmp: 

idp: Xerox 

named: 

ftpd: DARPA 

ip: 

inet: 

inetd: 

tcp: 

udp: 

whois: DARPA 

spline: 

implog: IMP log 

lisp: lisp 
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HAQUITICS:. © jar. see Fogg Sd Tes al wee Saeed Bt ewe, a Ea a 
insert literature references in documents. 
insert/remove element from a queue. 
insque, remque: insert/remove element from a queue. 
install binaries. 
install: install binaries. 
instruction about UNIX. 
interact with a psychoanalyst. 
interactive display-oriented text editor. 
interactive repair. 
interesting, adage. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
Interface. 
interface. /erase, label, line, circle, arc, move, 
interface. 
interface. ps: Evans 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface. 
interface encapsulating ns packets in ip packets.. 
interface parameters. 
interface to plot (3X) libraries.. 
interface to the TELNET protocol. 
interfaces. 
Interlan NI1010 10 Mb/s Ethernet interface. 
Interlan Np100 10 Mb/s Ethernet interface. 
Interlan Np100 10 Mb/s Ethernet interface. 
interleaved paging/swapping. 
internet. 
Internet address manipulation routines. 
Internet Control Message Protocol. 
Internet Datagram Protocol. 
Internet domain name server. 
Internet File Transfer Protocol server. 
Internet Protocol. 
Internet protocol family. 
internet ‘‘super—server’’. 
Internet Transmission Control Protocol. 
Internet User Datagram Protocol. 
Internet user name directory service. 
interpolate smooth curve. 
interpreter. 
interpreter. 
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ferror(3S) 
refer(1) 
insque(3) 
insque(3) 
install(1) 
install(1) 
learn(1) 
doctor(6) 
jove(1) 
fsck(8) 
fortune(6) 
acc(4) 
cons(4) 
crl(4) 
css(4) 
ct(4) 
ddn(4) 
de(4) 
dn(4) 
ec(4) 
en(4) 
ex(4) 

f1(4) 
hdh(4) 
hp(4) 
ht(4) 
hy(4) 
ik(4) 

il(4) 
imp(4) 
imp(4P) 
ix(4) 

lo(4) 
mt(4) 
mtio(4) 
np(4) 
pel(4) 
plot(3X) 
plot(5) 
ps(4) 
ge(4) 
rx(4) 
tm(4) 
tmscp(4) 
ts(4) 
tty(4) 
tu(4) 
uda(4) 
ut(4) 
uu(4) 
va(4) 
vp(4) 
nsip(4) 
ifconfig(8C) 
plot(3F) 
telnet(1C) 
slattach(8C) 
il(4) 

ix(4) 
np(4) 
swapon(2) 
sendmail(8) 
inet(3N) 
icmp(4P) 
idp(4P) 
named(8) 
ftpd(8C) 
ip(4P) 
inet(4F) 
inetd(8) 
tep(4P) 
udp(4P) 
whois(1) 
spline(1G) 
implog(8C) 
lisp(1) 
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px: Pascal 

uuxqt: UUCP execution file 

pix: Pascal 

pi: Pascal 

csh: a shell (command 

pipe: create an 

atomically release blocked signals and wait for 
siginterrupt: allow signals to 

onintr: process 

intro: 

intro: 

intro: 

math: 

networking: 

resintro: 

intro: 

intro: 

commands. intro: 

ncheck: generate names from 

(temporary). infnan: signals 

asinh, acosh, atanh: 

atan, atan2: trigonometric functions and their 
m_in, mout,/ madd, msub, mult, mdiv, pow, gcd, 
in a bibliography. indxbib, lookbib: build 
tread, twrite, trewin, tskipf, tstate: {77 tape 
ioinit: change {77 

select: synchronous 

iostat: report 

popen, pclose: initiate 


network interface encapsulating ns packets in 
rand, drand, 

random, drandm, 

sail: multi-user wooden ships and 

isalpha, isupper, islower, isdigit, isxdigit, 
isalnum, isspace, ispunct, isprint, isgraph,/ 
/isspace, ispunct, isprint, isgraph, iscntrl, 
ttynam, 

ttyname, 

/isalnum, isspace, ispunct, isprint, isgraph, 
isprint, isgraph,/ isalpha, isupper, islower, 
/isxdigit, isalnum, isspace, ispunct, isprint, 
ispunct, isprint, isgraph,/ isalpha, isupper, 
/isdigit, isxdigit, isalnum, isspace, ispunct, 
/islower, isdigit, isxdigit, isalnum, isspace, 
/isupper, islower, isdigit, isxdigit, isalnum, 
system: 

isspace, ispunct, isprint, isgraph,/ isalpha, 
isgraph,/ isalpha, isupper, islower, isdigit, 
formatter; list bibliographic reference 
idate, 

omin, fmin, m_in, mout, omout, fmout, m_out, sdiv, 


jo, 

JO, jl, 

bg: place 

fg: bring 

jobs: print current 
stop: halt a 

kill: kill 

Iprm: remove 


atrm: remove 
atq: print the queue of 


msgs: system messages and 

makekey: generate encryption 

mset: retrieve ASCII to IBM 3270 

database for mapping ascii keystrokes into IBM 3270 
map3270: database for mapping ascii 

apropos: locate commands by 
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interpreter. 

interpreter. . 

interpreter and executor. 

interpreter code translator. 

interpreter) with C-like syntax. 

interprocess communication channel. 

interrupt. sigpause: 

interrupt system calls. 

interrupts in command scripts. 

introduction to C library functions. 

introduction to commands. 

introduction to FORTRAN library functions. 
introduction to mathematical library functions. 
introduction to networking facilities. 
introduction to RCS commands. 
introduction to special files and hardware support 
introduction to system calls and error numbers. 
introduction to system maintenance and operation 
i-numbers. 

invalid floating-point ppenitions’ ona VAX 
inverse hyperbolic functions. 

inverses. sin, cos, tan, asin, acos, 

invert, rpow, msqrt, mcmp, move, min, omin, fait 
inverted index for a bibliography, find references 
I/O. topen, tclose, 

1/O initialization. 

I/O multiplexing. 

I/O statistics. 

1/O to/from a process. 

ioctl: control device. 

ioinit: change f77 I/O initialization, 

iostat: report I/O statistics. 

ip: Internet Protocol. 

ip packets.. nsip: software 

irand: return random values. 

irandm: better random number peuemian 

iron men. 

isalnum, isspace, ispunct, isprint, iseraph, / 
isalpha, isupper, islower, isdigit, isxdigit, 
isascii, toupper, tolower, toascii: character/ 
isatty: find name of a terminal port. 

isatty, ttyslot: find name of a terminal. 

iscntrl, isascii, toupper, tolower, toascii:/ 
isdigit, isxdigit, isalnum, isspace, ispunct, 
isgraph, iscntrl, isascii, toupper, tolower,/ 
islower, isdigit, isxdigit, isalnum, isspace, 
isprint, isgraph, iscntrl, isascii, toupper,/ 
ispunct, isprint, isgraph, iscntrl, isascii,/ 
isspace, ispunct, isprint, isgraph, iscntrl,/ 

issue a shell command. 7 
isupper, islower, isdigit, jeedinil: alien, 
isxdigit, isalnum, isspace, ispunct, isprint, 
items. bib, listrefs: bibliographic 

itime: return date or time in numerical form. 5 
itom: multiple precision integer arithmetic. jmin, 
ix: Interlan Np100 10 Mb/s Ethernet interface. 
j0, j1, jn, yO, yl, yn: bessel functions. 

jl, jn, yO, yl, yn: bessel functions. 

jn, yO, y1, yn: bessel functions. 

job in background. 

job into foreground. 

job list. 

job or process. 

jobs and processes. 

jobs from the line printer spooling quelle, 

jobs: print current job list. 

jobs spooled by at. 

jobs waiting to be run. 

join: relational database Spemier ; 
jove: an interactive display-oriented text Editon 
junk mail program. 

key. .. 

keyboard aoe 

keys. map3270: .. 

keystrokes into IBM 3270 keys. 

keyword lookup. E 
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px(1) 
uuxqt(8C) 
pix(1) 

pi(1) 

esh(1) 
pipe(2) 
sigpause(2) 
siginterrupt(3) 
csh(1) 
intro(3) 
intro(1) 
intro(3F) 
math(3M) 
intro(4N) 
resintro(1) 
intro(4) 
intro(2) 
intro(8) 
ncheck(8) 
infnan(3M) 
asinh(3M) 
sin(3M) 
mp(3X) 
lookbib(1) 
topen(3F) 
ioinit(3F) 
select(2) 
iostat(1) 
popen(3) 
ioctl(2) 
ioinit(3F) 
iostat(1) 
ip(4P) 
nsip(4) 
rand(3F) 
random(3F) 
sail(6) 
ctype(3) 
ctype(3) 
ctype(3) 
ttynam(3F) 
ttyname(3) 
ctype(3) 
ctype(3) 
ctype(3) 
ctype(3) 
ctype(3) 
ctype(3) 
ctype(3) 
system(3) 
ctype(3) 
ctype(3) 
bib(1) 
idate(3F) 
mp(3X) 
ix(4) 
j0(3M) 
j0@M) 
j0(3M) 
esh(1) 
esh(1) 
esh(1) 
esh(1) 
esh(1) 
Iprm(1) 
esh(1) 
atrm(1) 
atq(1) 
join(1) 
jove(1) 
msgs(1) 
makekey(8) 
mset(1) 
map3270(5) 
map3270(5) 
apropos(1) 
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man: find manual information by 


profile buffers. 
kill: 


bessel functions: of two 

kg: 

mem, 

linemod, space, closepl:/ plot: openpl, erase, 


awk: pattern scanning and processing 

be: arbitrary-precision arithmetic 

efi: Extended Fortran 

set, shift, times, trap, umask, wait: command 
fp: Functional Programming 

verindefs: vgrind’s 

order. 


frexp, 


leave: remind you when you have to 


exit: 

getusershell, setusershell, endusershell: get 
index, rindex, Inblnk, 

truncate: truncate a file to a specified 
getopt: get option 


lex: generator of 


acc: ACC 

css: DEC IMP-11A 

terminal. 

et al.: £77 library interface to plot (3X) 
ranlib: convert archives to random 
lorder: find ordering relation for an object 
ar: archive 

intro: introduction to C 

intro: introduction to FORTRAN 
math: introduction to mathematical 
plot: openpl et al.: £77 

ar: archive and 


limit: alter per-process resource 
unlimit: remove resource 

quota: display disc usage and 

getarg, iargc: return command 

space, closepl:/ plot: openpl, erase, label, 
kg: KL-11/DL-11W 

tb: 

(obsolete). bk: 

col: filter reverse 

sysline: display system status on status 
Ipr: off 


Iprm: remove jobs from the 
/erase, label, line, circle, arc, move, cont, point, 
Iptest: generate 

head: give first few 

unifdef: remove ifdef’ ed 

slattach: attach serial 

comm: select or reject 

fold: fold long 

uniq: report repeated 

look: find 

rev: reverse 

readlink: read value of a symbolic 
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- xlix - 

keywords; printoutthe manual. .........-228.0- man(1) 
kg: KL-L1/DL-11W lineclock. 2... 2... 2 2 eee kg(4) 
kgmon: generate a dump of the operating system’s ..... kgmon(8) 
kill jobs and processes. =. 2. 6 2 eee ee ee ee ee csh(1) 
kill: kill jobs and processes. =. 2. 2. 2 ee ee ee ee ee csh(1) 
kill: senda signaltoaprocess. ... 2... ee ee eee kill3F) 
kill: send signal toa process. ... 2... 2. ee ee eee kill(2) 
kill: terminate a process with extreme prejudice. ...... kill(1) 
killpg: send signal toa process group. ......-+.-. killpg(2) 
kinds forinteger orders. . . 2... ee ee ee ee ee bessel(3F) 
KL-11/DL-11W line clock. . 2... 1... ee ee eee kg(4) 
kmem: mainmemory. . . 2... 6 1 ee ee ee ee mem(4) 
label, line, circle, arc, move, cont, point, ......... plot(3X) 
L.aliases: UUCP hostname alias file. ........... L.aliases(5) 
Waniguage:> 8. else ers we te ae es Gn a a ee cas oe awk(1) 
Man guages: ve. cere he ce ie ee te a sae i Ge ca ie ee be(1) 
Panguage. Sister eee eS Nat we aE ss Bw ceed efl(1) 
language. /exit, export, login, read,readonly, ....... sh(1) 
language compiler/interpreter. . 2... 2. ee ee ee ee fp(1) 
language definition database. . ...... 2... ee ee verindefs(5) 
lastcomm: show last commands executed inreverse ..... lastcomm(1) 
L.cmds: UUCP remote command permissions file. .... . L.cmds(5) 
Id#link: 6ditOr.: 6s. 38 55 ee th age tel od EO Ses, Bae se oe Id(1) 
L-devices: UUCP device description fille. ......... L-devices(5) 
ldexp, modf: split into mantissa and exponent. ....... frexp(3) 
L-dialcodes: UUCP phone number index file. ....... L-dialcodes(5) 
learn: computer aided instruction about UNIX. ....... learn(1) 
WEAVES. wis Nek, nace costo as way asa e as 1S, nat use emis ater leave(1) 
leave: remind you when you have toleave. ........ leave(1) 
leave:shells; 3 gozeRe-eiedce ie ete dae hie Beas EE esh(1) 
legalusershells. 2. 2 1 1 1 we ee ee ee ee ee getusershell(3) 
len: tell about character objects. . 2... 2... ee ee ee index(3F) 
WEN thies. ves ve %. caccg) ets By oe ces tS U8! ws Meet Fg tales So ey cad truncate(2) 
letterfromargv. . 6 6 eee ee ee ee ee ee getopt(3) 
lex: generator of lexical analysis programs. ........ lex(1) 
lexical analysis programs. . . 2... ee ee ee ee ee lex(1) 
lgamma: log gamma function. . 2... 2. ee ee ee lgamma(3M) 
LH/DHIMPinterface. ........2.226-62+2064 acc(4) 
LH/DHIMPinterfacen ... 2... 2.2 ee eee eee css(4) 
lib2648: subroutines for the HP 2648 graphics ....... 1ib2648(3X) 
libraries. plot: openplh .........-.2.-+4202- plot(3F) 
Libraries... 15. 6s eee Re OS OR UE Se ranlib(1) 
Library® e+ ce oe ear ie en a eae we SN ec le a lorder(1) 
(library) fileformat. . 2... 6 ee ee ee ee ee ar(5) 
library functions: wees. Soe Sek ee se we ES eS ees intro(3) 
library functions, 6s. 0.06 else ee ae ee wee intro(3F) 
library functions. 2... 1 1 ee ee ee ee ee ee math(3M) 
library interface to plot (3X) libraries. . ......22. plot(3F) 
library maintainer, . 2... 2 eee ee ee ee ee ar(1) 
limit: alter per-process resource limitations. ........ csh(1) 
limitations, <<. 4) h% tte eae Bb eine dk. 2 eh ite hd oS! csh(1) 
TiritiAtONS.< oso. [ AS we ee hee oe Se oS a Get OE we Sn esh(1) 
TEATS 2. ia Fane tee RAN AN tae Gasrtge BO CE AY Se Gat ee Sek A tee Gottee Le quota(1) 
linearguments. . 2 1 we ee ee ee ee ee getarg(3F) 
line, circle, arc, move, cont, point, linemod, ........ plot(3X) 
line clocks | cag ceNsee4i- be eee Gee a aide SS kg(4) 
line discipline for digitizing devices. ........4.24.- tb(4) 
line discipline for machine-machine communication ..... bk(4) 
NE TCEOR A | Se evga AE Sas OO RE Ss col(1) 
linesof atterminale” 0-36. “sc ak eee ee a oe eS es sysline(1) 
Mine Prints, «35-30 ee ee e's eh RNS Ae Se ak EO ee aoe Ipr(1) 
line:printers 2h ca) ioe ges: WO eco the 8 os “ee Ts Se eed Ip(4) 
line printer control program. .........62+-+0e-. Ipe(8) 

: lineprinterdaemon. .........-+620-0255000- Ipd(8) 
line printer spooling queue. . . 2... 2 ee ee ee ee Iprm(1) 
linemod, space, closepl: graphics interface. ........ plot(3X) 
lineprinter ripple pattern. . 2... 1. 1 eee ee ee ee Iptest(1) 
TimeS:. % Zarjve. fe, os Re a eh tec ch, ered be Sh eg Gy aed head(1) 
MIMS, = hee ts a ae Sod hy tot eat ebay fee GALES oat he tee agent LS unifdef(1) 
lines as network interfaces. . 2... 1. 6 ee ee ee ee slattach(8C) 
lines common to two sorted files. .......4.4.2426- comm(1) 
lines for finite width output device. . . 2... ...2.24- fold(1) 
lines it ase s,s. coy ce tae 8 wd, hs hs eee is Sa, RE RL ae Ea ee uniq(1) 
linesinasortedlist. . 2... 1 1 1 ee ee ee ee ee look(1) 
Mines,OF a fileey oyize2 eo Ab. deh St ae nere Se take Soh Gene 4 ee le Se rev(1) 
WT, 65 83.3 Sept ee ae ah ES ew: Sek Wee RY oe Gs a EE os readlink(2) 
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Id: 
a.out: assembler and 


link: make a hard 
symlink: make symbolic 
link: make a 

In: make 


Ixref: 
lisp: 


liszt: compile a Franz 

troff. vip: Format 

glob: filename expand argument 
history: print history event 

jobs: print current job 

shift: manipulate argument 
getgroups: get group access 
initgroups: initialize group access 
look: find lines in a sorted 

nlist: get entries from name 

nm: print name 

setgroups: set group access 
symorder: rearrange name 
varargs: variable argument 

bib, listrefs: bibliographic formatter; 
Is: 

uuname: 

foreach: loop over 

users: compact 

listen: 


verind: grind nice 
bibliographic reference items. bib, 


refer: find and insert 


index, rindex, 


and time to ASCII. ctime, 

(csh only). which: 

apropos: 

whereis: 

end, etext, edata: last 

flock: apply or remove an advisory 


collect system diagnostic messages to form error 
logger: make entries in the system 

openlog, closelog, setlogmask: control system 
uulog: display UUCP 

lgamma: 

implog: IMP 

power. exp, expm1, 

syslogd: 

exp, expm1, log, 

exp, expm1, log, log10, 

exp, expm1, log, log10, log1p, pow: exponential, 
manipulations. copysign, drem, finite, 

rwho: who’s 


implogd: IMP 

flush: flush output to a 

fseek, ftell: reposition a file on a 

getc, fgetc: get a character from a 

putc, fputc: write a character to a fortran 
rlogin: remote 

ac: 


getlog: get user’s 

getlogin: get 

login: 

/break, continue, cd, eval, exec, exit, export, 
utmp, wtmp: 

rlogind: remote 
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Vink @ditOrs. «se. che Se Soe cee Seg cabs eee a Se Te Se Id(1) 

link editoroutput. ... 1... 2... ee ee ee eee a.out(5) 

link: make ahardlinktoafile. ...........6.6. link(2) 

link: make a link to anexisting file. ........... link(3F) 

Winkstoahiles= - 2.45 “yu e id: ee bahar. > a Lee Sek tae ee oe link(2) 

Winks tOva TIES, — “= espe ts. eo tee a ES Se See eA Ei letite Des ADs symlink(2) 

link to an existing file. . .........2.2-602-0024. link(3F) 

TMS", * Ae tE estes LED Oa: AY ee woe ee Lees Leak Teoh iat aw tae wat ee In(1) 

lint: aC program verifier. . . 2... 2.2.2.2. eee eee lint(1) 

lisp cross reference program. ........-6-2-+ ees Ixref(1) 

lisp interpreters. © <6 62 66 eS wR a eae lisp(1) 

lisp: lispinterpreter. . 2... 2.2... eee ee eee lisp(1) 

Lispiprogtaims "s 2. 56, teense utes es cies las Te Te a ee Cs liszt(1) 

Lisp programs to be printed with nroff, vtroff,or ...... vip(1) 

TiSte-* ces 'ee2s ce ya nei ds on Za Be ces Sacda aed Boe tae ee RSE oe esh(1) 

MISE; * eda. tes Gite se Bote Se oak dee ees Gare See aE Sa Res esh(1) 

DSCs. Sever ep fy cig Ge Cag Ss oF. Ge ed Ee SIG Gee Ses ce Sp SD DE Meee csh(1) 

TiStes 5s ve .5 Cg St eke Seow. CaS SRS Gee 3 ee ae oe esh(1) 

MiSt. Tbs dee es Bitten de wh AE ite deals. AY Gitte ka Bus! z getgroups(2) 

DiStim. see tes is Zee Cong Rs) TEs Fy Ses Ge tse ls ee Ses Ca cs MSPs? TS Gee ce initgroups(3) 

MISES 5.4 %e¥ "Se oats Eo et ey te Geet: Van het Var te Seti hee “a Sorte Le look(1) 

MISES. di te See i Rh th teehee Ao ae Bite “eet, SO SiMe he: GOA RB nlist(3) 

TASC oss oes Sev aS Gad “eat ASS, WH Sab SN oak BS oe Sat ORS ve, Get AE hoo TNS nm(1) 

MiSte es he cee yet se S eeR AY Se Goes LOG ae oe st ae EE ae ea Bs setgroups(2) 

List, eae 8) ve yo Base Sah Roe Mee SE oe FP symorder(1) 

TASC oe 65° Wao Ay SOS SS el ANE ph SSS Gia) BNET Sk CDE, eA be PSY F varargs(3) 

list bibliographic reference items. .........4.2+.6- bib(1) 

list contents of directory, . . 6... 2 ee ee ee ee ee Is(1) 

list names of UUCP hosts. . . 2... 4.2.2. ee ee eee uuname(1C) 

listiofinames:.. . 2 2s: ses eS Gente iel eh ede Ghia Ba EE esh(1) 

list of users who are onthe system. . .......+2-. users(1) 

listen for connections onasocket. .......+.e2e- listen(2) 

listen: listen for connections onasocket. .......6.4-. listen(2) 

listings of programs. .. 2... 2.6. eee ee ee eee verind(1) 

listrefs: bibliographic formatter; list ........2.24.2.- bib(1) 

liszt: compile a Franz Lisp program. ........+..-. liszt(1) 

literature references in documents. ........2-+ee08 refer(1) 

Insmake-Hnks.. 44) 5% p%. ts seas AAR ee: ee tee. eA In(1) 

InbInk, len: tell about character objects. . ......... index(3F) 

lo: software loopback network interface. ......... lo(4) 

loc: return the address of anobject. . 2... 2... 2... eee loc(3F) 

localtime, gmtime, asctime, timezone: convertdate ..... ctime(3) 

locate a program file including aliases and paths ...... which(1) 

locate commands by keyword lookup. .........-. apropos(1) 

locate source, binary, and or manual for program. . ..... whereis(1) 

locations in program. .. 1... ee ee ee ee ee ee end(3) 

lock onanopenfile .........42.0-628-+008-. flock(2) 

lock: reserveaterminal. . . 1... 6... ee ee eee lock(1) 

log AdiMES Be eh eves ast oe Be ced SRE SS aed dmesg(8) 

LOGS teat tek Fee Ptae S aaah Me ISR: an Get AE ESP ALGLAN E OER Le logger(1) 

OSs: "SVSIOS;. 2s. AP si viene. Bo a) ie Ue Sots BO i ibd: we! S syslog(3) 

Nop filesis “ns sends go. ce $8 Ge hoe ORS SC a Get Se ts uulog(1C) 

log gamma function .. 1... 1 ee ee ee ee ee lgamma(3M) 

log interpreters. .e. Soe. idh So apse Se we, oe, Mase Sw ee implog(8C) 

log, log10, log1p, pow: exponential, logarithm, ....... exp(3M) 

log systems messages. . 2... ee ee ee ee ee ee syslogd(8) 

log10, log1p, pow: exponential, logarithm, power. ..... exp(3M) 

log|p, pow: exponential, logarithm, power. ........ exp(3M) 

logarithm, power, 2. 2. 1 ee ew ee ee ee ee ee exp(3M) 

logb, scalb: copysign, remainder,exponent ........ ieee(3M) 

logged in on local machines. .........-6.2-0e00- rwho(1C) 

logger: make entries inthe systemlog. .......... logger(1) 

logger process. 5 ee eis ea ew ew we implogd(8C) 

logical Units 25 io tbe da eee AP ee Petia ete AL flush(3F) 

logical Uniti. ~ . re. cents eRe cave tae Te Gi Vere tae Be ca fseek(3F) 

lOgicaltunith.s 5 2 veces he te wes et vate ay 2 Be ag eh he ah ee ak Ue getc(3F) 

logicalunity. si. #80 ce Ae EE RUE ies. Sas putc(3F) 

OSIM. a Ge. ob Stale by eet eee a Sk cee A rlogin(1C) 

login:aCcOunUNes se. ie. es ae A Se a Le ee we ac(8) 

login: loginnewuser. . . 2... eee ee ee ee eee csh(1) 

loginname. 2... 6 1 wee ee ee we ee ee ee getlog(3F) 

login NAME. ~ ss: <o. 95 Soe had. Sy es Bel OS el Se we getlogin(3) 

login NewlSete. 46 es Ie ay a Weise, ee sy SE ae esh(1) 

login, read, readonly, set, shift, times, trap/ ........ sh(1) 

login fecords sy! oes eo ene bel eel Be Ge eek ae eS utmp(5) 

TOSIN:- SEFVER:,- Sosa Soe seb Bes gee Nae GES ak ee Se Ee rlogind(8C) 
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tn3270: full-screen remote 
last: indicate last 


setjmp, 


find references in a bibliography. indxbib, 
apropos: locate commands by keyword 
finger: user information 

break: exit while/foreach 

continue: cycle in 

end: terminate 

foreach: 

lo: software 

library. 

mklost+found: make a 


queue. 


bit: and, or, xor, not, rshift, 
Stat, 
Stat, 


time, ctime, 


bk: line discipline for 

ruptime: show host status of local 

twho: who’s logged in on local 

m4: 

alias: shell 

toupper, tolower, toascii: character classification 
ms: text formatting 

me: 

man: 

msqrt, mcmp, move, min, omin, fmin, m_in, mout,/ 
tcopy: copy a 

mt: 

ht: TM-03/TE-16,TU-45,TU-77 MASSBUS 
mt: TM78/TU-78 MASSBUS 

mtio: UNIX 

tm: TM-11/TE-10 

tmscp: DEC TMSCP 

ts: TS-11 

rmt: remote 

mail: send and receive 

encode/decode a binary file for transmission via 
xsend, xget, enroll: secret 

sendbug: 

mailaddr: 

newaliases: rebuild the data base for the 
binmail: send or receive 

biff: be notified if 

from: who is my 

sendmail: send 

msgs: system messages and junk 

rmail: handle remote 


mem, kmem: 

make: 

ar: archive and library 
intro: introduction to system 
mkdir: 

mkdir: 

link: 

link: 

mklost+found: 
mknod: 

mktemp: 
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login: sign on. 
login to IBM VM/CMS. 
logins of users and teletypes. 
logout: end session. 
longjmp: non-local goto. 
look: find lines in a sorted list. 
lookbib: build inverted index for a bibliography, 
lookup. 
lookup program. 
loop. 


loop over list of names. 
loopback network interface. 
lorder: find ordering relation for an object 
lost+found directory for fsck. 
Ip: line printer. 
Ipe: line printer control program. 
Ipd: line printer daemon. 
Ipq: spool queue examination program. 
Ipr: off line print. 
Iprm: remove jobs from the line printer spooling 
Iptest: generate lineprinter ripple pattern. 
Is: list contents of directory. 
lseek: move read/write pointer. 
Ishift bitwise functions. 
Istat, fstat: get file status. 
Istat, fstat: get file status. 
L.sys: UUCP remote host description file. 
Itime, gmtime: return system time. 
Ixref: lisp cross reference program. 
m4: macro processor. 
machine-machine communication (obsolete). 
machines. 
machines. 
macro processor. 
macros. 
macros. /isprint, isgraph, iscntrl, isascii, 
macros. 
macros for formatting papers. 
macros to typeset manual. 
madd, msub, mult, mdiv, pow, gcd, invert, rpow, 
mag tape. 
magnetic tape manipulating program. 
magtape interface. 
magtape interface. 
magtape interface. 
magtape interface. 
magtape interface. 
magtape interface. 
magtape protocol module. 
mail. 
mail. uuencode, uudecode: 
mail. 
mail a system bug report to 4bsd-bugs. 
mail addressing description. 
mail aliases file. 
mail among users. 
mail arrives and who it is from. 
mail from?. 
mail over the internet. 
mail program. 
mail received via uucp. 
mail: send and receive mail. 
mailaddr: mail addressing description. 
main memory. 
maintain program groups. 
maintainer. 
maintenance and operation commands. 
make a directory. 
make a directory file. 
make a hard link to a file. 
make a link to an existing file. 
make a lost+found directory for fsck. 
make a special file. 
make a unique file name. 
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login(1) 
tn3270(1) 
last(1) 
esh(1) 
setjmp(3) 
look(1) 
lookbib(1) 
apropos(1) 
finger(1) 
esh(1) 


lorder(1) 
mklost+found(8) 


Iptest(1) 
Is(1) 
lseek(2) 
bit(3F) 
stat(2) 
stat(3F) 
L.sys(5) 
time(3F) 
Ixref(1) 
m4(1) 
bk(4) 


rwho(1C) 
csh(1) 


ms(7) 
me(7) 
man(7) 
mp(3X) 
tcopy(1) 
mt(1) 


mtio(4) 
tm(4) 
tmscp(4) 


mail(1) 
uuencode(1C) 
xsend(1) 
sendbug(1) 
mailaddr(7) 
newaliases(1) 
binmail(1) 
biff(1) 
from(1) 
sendmail(8) 
msgs(1) 
rmail(1) 
mail(1) 
mailaddr(7) 


mkdir(1) 


link(2) 

link(3F) 
mklost+found(8) 
mknod(2) 
mktemp(3) 
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logger: 
In: 


symlink: 
makedev: 
vwidth: 
script: 


allocator. 
the manual. 


route: manually 

uuq: examine or 

mt: magnetic tape 

inet_Inaof, inet_netof: Internet address 
finite, logb, scalb: copysign, remainder, exponent 
frexp, ldexp, modf: split into 

catman: create the cat files for the 

find manual information by keywords; print out the 
man: macros to typeset 

whereis: locate source, binary, and or 
manual. man: find 

route: 

IBM 3270 keys. 

map3270: database for 

umask: change or display file creation 
sigsetmask: set current signal 

umask: set file creation mode 

mkstr: create an error message file by 
hp: 

ht: TM-03/TE-16,TU-45,TU-77 

mt: TM78/TU-78 

functions. 

math: introduction to 

eqn, neqn, checkeq: typeset 


getrlimit, setrlimit: control 
vlimit: control 

de: DEC DEUNA 10 

ec: 3Com 10 

en: Xerox 3 


ex: Excelan 10 

il: Interlan NI1010 10 

ix: Interlan Np100 10 

np: Interlan Np100 10 

qe: DEC DEQNA Q-bus 10 

/msub, mult, mdiv, pow, gcd, invert, rpow, msart, 
min, omin, fmin, m_in, mout,/ madd, msub, mult, 


bed: convert to antique 
vv: Proteon proNET 10 


groups: show group 

mem, kmem: main 

malloc, free, realloc, calloc, alloca: 
malloc, free, falloc: 

valloc: aligned 

vfork: spawn new process in a virtual 
core: format of 

vmstat: report virtual 

sail: multi-user wooden ships and iron 
sort: sort or 

pmerge: pascal file 


mkstr: create an error 

recv, recvfrom, recvmsg: receive a 

send, sendto, sendmsg: send a 

mh: 

icmp: Internet Control 

error: analyze and disperse compiler error 
mesg: permit or deny 

perror, sys errlist, sys _nerr: system error 
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make entries inthe systemlog. ........4..+-e.e- logger(1) 
make links. <j ovse26 03036 3 Wok Seen We eee OR el SB In(1) 

make: maintain program groups. . .... +... ee eee make(1) 
make symbolic linktoafile. .........4..+200- symlink(2) 
make system special files. ........6.-5. 52-5020 makedev(8) 
make troff width table forafont. ..........2..-. vwidth(1) 
make typescript of terminal session. ........42.6-. script(1) 
makedev: make system special files. ........... makedev(8) 
makekey: generate encryptionkey. ............ makekey(8) 
malloc, free, falloc: memory allocator. .......... malloc(3F) 
malloc, free, realloc, calloc, alloca: memory ........ malloc(3) 
man: find manual information by keywords; print out man(1) 
man: macros to typeset manual. ..........+.2.. man(7) 

: manipulate argumentlist .........4.6.2-+26-. csh(1) 

: manipulate disk quotas. . ...... 2.525. 5e ee eee quota(2) 
manipulate tape archive. . ... 1... ee ee ee ewe tp(1) 
manipulate the routing tables. . 2... 1... ee ee ee route(8C) 
manipulate the uucp queue. . 2... 1 2 ee ee ee ee uuq(1C) 
manipulating program. . .. 1... ee ee ee ee we mt(1) 
manipulation routines. /inet_ntoa,inet makeaddr, ..... inet(3N) 
manipulations. copysign,drem, ... 2... 2. eee eee ieee(3M) 
mantissaandexponent. . 2... 6. ee ee ee ee ee frexp(3) 
Manuals, © vs. sr og ese BS sl Rk RS ee catman(8) 
Matival,*mians. 22 eb \odi Ae te Gehias 29 SE 2 Ae oe gt ae Boek AN te Gotta Le man(1) 
Marital: 7a Fe nee Sah Ree We, oe VS ee So we man(7) 
manual for program. .... 2... ee ee ee ee we whereis(1) 
manual information by keywords; printoutthe ....... man(1) 
manually manipulate the routing tables. . .........- route(8C) 
map3270: database for mapping ascii keystrokes into map3270(5) 
mapping ascii keystrokes into IBM 3270 keys. ....... map3270(5) 
MASK 5S Ses wee hopes. (ARS cab ces Saha UE ses ve? Gnade a Lea csh(1) 
MASK: errs te sree SOs dee Gah Roe ee Se EO Ge ah ee sigsetmask(2) 
MASK). 3S: ay Cong. PSS Ae Se eit 82 oe epee da. ales Fo tee cece umask(2) 
massaging C source. . . 2.6 1 eee ew ee ee ee mkstr(1) 
MASSBUS disk interface. . 2... 2... 2... ee eee hp(4) 
MASSBUS magtape interface. . 2... 2. ee ee ee ht(4) 
MASSBUS magtape interface. . 2... 1... ee ee ee mt(4) 
math: introduction to mathematical library ......... math(3M) 
mathematical library functions. . .. 1... 2. ee eee math(3M) 
mathematics. 6038 -otn Zee Sas Ee ose i a eqn(1) 
maximum system resource consumption. ......... getrlimit(2) 
maximum system resource consumption. ......... vlimit(3C) 
Mb/s Ethernet interface. . 2... 2.1 eee ee eee de(4) 

Mb/s Ethernet interface. . 2... 2. eee ee eee ec(4) 
Mb/s Ethernet interface. . 2... 1... 2 ee ee ee we en(4) 
Mb/s Ethernet interface. . . 2... 2. 2 ee ee ee ee ex(4) 
Mb/s Ethernet interface. . . 1... 1. eee ee ee ee il(4) 
Mb/s Ethernet interface. . 2... 2. eee ee ee ee ix(4) 
Mb/s Ethernet interface. . 2... 1... 2 ee ee ee ee np(4) 
Mb/s Ethernet interface. . . 1... 1 1 ee eee ee ee qe(4) 
mcemp, move, min, omin, fmin, m_in, mout,omout/ ..... mp(3X) 
mdiv, pow, gcd, invert, rpow, msqrt, mcmp, move, ..... mp(3X) 
me: macros for formatting papers. ........-+2e- me(7) 
Medias. vee if ep ve we, wise Swe, ee See RS, ee Sow ae F bed(6) 
Megabitring:. ys. Se ese oR hs NE Ew Fa ee vv(4) 
mem, kmem:mainmemory. ........+-s-+ee-48 mem(4) 
Memberships: a i. Wise id, oe Ge Dae Wes oe sie oa aes groups(1) 
MEMO Ys. 74: tes See, ee ara es aie ie Re Ree eee mem(4) 
memory allocator, s-23- se ce el ee ee malloc(3) 
memory allocator, ... 2... ee ee ee ee ee we malloc(3F) 
memory allocator, . .. 1... eee ee ee eee ee valloc(3C) 
memory efficient way. . . . 6... 2 ee ee ee ee ee vfork(2) 
memory image file. 2... 2 1 eee ee ee ee eee core(5) 
Memory-statistics; 6 ssw a ete ewe, vmstat(1) 
MMEM:, goss. Ar cdiag. 121d) He. Be cesues tan iss | oe de SD eer ceed sail(6) 
mersefiles:. » 26 si/Le “ean Mee cee ch Wate as tee ea) a sort(1) 
METQer:. © &. witehie tte oes er SM ete Ste SUS Gite ce: wish s pmerge(1) 
mesg: permit or deny messages. . . 2... 2.2.2. ee eee mesg(1) 
message file by massaging C source. . 2... 2... ee ee mkstr(1) 
message froma socket. . .. 2... ee ee ee eee recv(2) 
message fromasocket. . .. 2... eee eee ee ee send(2) 
Message Handler. <6. ee we we a mh(1) 
Message Protocol . .. 2... ee ee ee ee eee icmp(4P) 
IMESSASESS 2 'ets.hs, ohce Te Glo tues dev Sh fey Peg tueses ee aehh ees error(1) 
MNESSABESS <5) v6 to! Ge oe ’owo Gb: do Set ten sete To set Soe Geto oe ee de SG Ue mesg(1) 
MICSSAGES: +s. >see Fe cos Aes aN nee Se SEY: a ea IY Ler Gos Gta. a See oe perror(3) 
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perror, gerror, ierrno: get system error 
psignal, sys_siglist: system signal 
syslogd: log systems 

msgs: system 

dmesg: collect system diagnostic 


mille: play 


invert, rpow, msqrt, mcmp, move, min, omin, fmin, 
/mdiv, pow, gcd, invert, rpow, msqrt, mcmp, move, 


pages. 
miscellaneous: 


source. 


chmod: change 

getty: set terminal 

umask: set file creation 
chmod: change 

chmod: change 

ddn: DDN Standard 

frexp, ldexp, 

touch: update date last 

rmt: remote magtape protocol 
up: unibus storage 

what: show what versions of object 
monitor, monstartup, 

profile. 


monop: 
monitor, 


curses: screen functions with ‘‘optimal’’ cursor 
mount, umount: 
mount, umount: 


mtab: 

/rpow, msqrt, mcmp, move, min, omin, fmin, m_in, 
/move, min, omin, fmin, m_in, mout, omout, fmout, 
plot: openpl, erase, label, line, circle, arc, 

/mult, mdiv, pow, gcd, invert, rpow, msqrt, mcmp, 
mv: 

Iseek: 

hk: RK6-11/RK06 and RKO7 


madd, msub, mult, mdiv, pow, gcd, invert, rpow, 
mcmp, move, min, omin, fmin, m_in, mout,/ madd, 


move, min, omin, fmin, m_in, mout,/ madd, msub, 
hunt: a 

fmin, m_in, mout, omout, fmout, m_out, sdiv, itom: 
dh: DH-11/DM-11 communications 

dhu: DHU-11 communications 

dz: DZ-11 communications 

select: synchronous I/O 

dmf: DMF-32, terminal 

dmz: DMZ-32 terminal 

fsplit: split a 

hunt: a multi-player 

sail: 

switch: 
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messages. 
messages. 
messages. 
messages and junk mail program. 
messages to form error log. 
mh: Message Handler. 
Mille Bournes. 
mille: play Mille Bournes. 
m_in, mout, omout, fmout, m_out, sdiv, itom:/ /gcd, 
min, omin, fmin, m_in, mout, omout, fmout, m_out,/ 
miscellaneous: miscellaneous useful information 
miscellaneous useful information pages. 
mkdir: make a directory. 
mkdir: make a directory file. 
mkfs: construct a file system. 
mkhosts: generate hashed host table. 
mklost+found: make a lost+found directory for fsck. 
mknod: build special file. 
mknod: make a special file. 
mkpasswd: generate hashed password table. 
mkproto: construct a prototype file system. 
mkstr: create an error message file by massaging C 
mktemp: make a unique file name. 
mode. 
mode. 
mode mask. 
mode of a file. 
mode of file. 
Mode X.25 IMP interface. 
modf: split into mantissa and exponent. 
modified of a file. 
module. 
module controller/drives. 
modules were used to construct a file. 
moncontrol: prepare execution profile. 
monitor, monstartup, moncontrol: prepare execution 
monop: Monopoly game. 
Monopoly game. 
monstartup, moncontrol: prepare execution profile. 
more, page: file perusal filter for crt viewing. 
motion. 
mount and dismount file system. 
mount or remove file system. 
mount, umount: mount and dismount file system. 
mount, umount: mount or remove file system. 
mounted file system table. 
mout, omout, fmout, m_out, sdiv, itom: multiple/ 
m_out, sdiv, itom: multiple precision integer/ 
move, cont, point, linemod, space, closepl:/ 
move, min, omin, fmin, m_in, mout, omout, fmout,/ 
move or rename files. 
move read/write pointer. 
moving head disk. 
ms: text formatting macros. 
mset: retrieve ASCII to IBM 3270 keyboard map. 
msgs: system messages and junk mail program. 
msqrt, mcmp, move, min, omin, fmin, m_in, mout,/ 
msub, mult, mdiv, pow, gcd, invert, rpow, msqrt, 
mt: magnetic tape manipulating program. 
mt: TM78/TU-78 MASSBUS magtape interface. 
mtab: mounted file system table. 
mtio: UNIX magtape interface. 
mult, mdiv, pow, gcd, invert, rpow, msqrt, mcmp, 
multi-player multi-terminal game. 
multiple precision integer arithmetic. /min, omin, 
multiplexer. 
multiplexer. 
multiplexer. 
multiplexing. 
multiplexor. 
multiplexor. 
multi-routine Fortran file into individual files. 
multi-terminal game. 
multi-user wooden ships and iron men. 
multi-way command branch. 
mv: move or rename files. 
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perror(3F) 
psignal(3) 
syslogd(8) 
msgs(1) 
dmesg(8) 
mh(1) 
mille(6) 
mille(6) 
mp(3X) 
mp(3X) 
intro(7) 
intro(7) 
mkdir(1) 
mkdir(2) 
mkfs(8) 
mkhosts(8) 
mklost+found(8) 
mknod(8) 
mknod(2) 
mkpasswd(8) 
mkproto(8) 
mkstr(1) 
mktemp(3) 
chmod(1) 
getty(8) 
umask(2) 
chmod(3F) 
chmod(2) 
ddn(4) 
frexp(3) 
touch(1) 
rmt(8C) 
up(4) 
what(1) 
monitor(3) 
monitor(3) 
monop(6) 
monop(6) 
monitor(3) 
more(1) 
curses(3X) 
mount(8) 
mount(2) 
mount(8) 
mount(2) 
mtab(5) 
mp(3X) 
mp(3X) 


ms(7) 

mset(1) 
msgs(1) 
mp(3X) 


mt(4) 


dz(4) 
select(2) 
dmf(4) 
dmz(4) 
fsplit(1) 
hunt(6) 
sail(6) 
csh(1) 
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from: who is 

getdiskbyname: get disk description by its 
getenv: value for environment 
getlog: get user’s login 
getlogin: get login 
getsockname: get socket 
mktemp: make a unique file 
pwd: working directory 

tty: get terminal 

hosts: host 

networks: network 

protocols: protocol 

services: service 

whois: DARPA Internet user 
getpw: get 

nlist: get entries from 

nm: print 

symorder: rearrange 

rename: change the 

ttyname, isatty, ttyslot: find 
ttynam, isatty: find 
getpeername: get 
gethostname, sethostname: get/set 
hostnm: get 

hostname: set or print 

named: Internet domain 

bind: bind a 


foreach: loop over list of 
term: conventional 
ncheck: generate 
uuname: list 


eqn, 


rdump: file system dump across the 

rrestore: restore a file system dump across the 
ntohl, ntohs: convert values between host and 
getnetbyname, setnetent, endnetent: get 
gethostent, sethostent, endhostent: get 

ping: send ICMP ECHO_REQUEST packets to 
imp: 1822 

lo: software loopback 

pel: DEC CSS PCL-11 B 

packets.. nsip: software 

ifconfig: configure 

slattach: attach serial lines as 

networks: 

routed: 

netstat: show 

hy: 

ns: Xerox 

networking: introduction to 


creat: create a 

open a file for reading or writing, or create a 
newfs: construct a 

fork: create a 

vfork: spawn 

login: login 

adduser: procedure for adding 

aliases file. 


readnews: read 

vnews: read 

notes, autoseq, readnotes: a 

dbminit, fetch, store, delete, firstkey, 
il: Interlan 

gettable: get 

htable: convert 

verind: grind 

(sh only). 
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my mail from?. 

name. 

name. 

name. 

name. 

name. 

name. 

name. 

name. 

name data base, 

name data base. 

name data base. 

name data base. 

name directory service. 

name from uid. 

name list. 

name list. 

name list. 

name of a file. 

name of a terminal. 

name of a terminal port. 

name of connected peer. 

name of current host. 

name of current host. 

name of current host system. 

name server. 

name to a socket. 

named: Internet domain name server. 

names. 

names for eeeminals: 

names from i-numbers. 

names of UUCP hosts. 

ncheck: generate names from i- cainbets 
neqn, checkeq: typeset mathematics. 

netstat: show network status. 

network. 

network. 

network byte order. htonl, ‘tens, 

network entry. getnetent, getnetbyaddr, < 
network host entry. oie gethostbyaddr, 
network hosts. ae eve sete oa, Vers 8 
network interface. 

network interface. 

Network Interface. : 

network interface sneapeulitine ns packetsin in ip 
network interface parameters. 

network interfaces. 

network name data base. 

network routing daemon. 

network status. 

Network Systems Hyosichannel nites 
Network Systems(tm) protocol family. 
networking facilities. : 

networking: introduction to neiwerking facilities: 
networks: network name data base. 

new file. 

new file. open: 

new file system. 

new process. : 
new process in a wautialis memory PEtGent 9 way. 
new user. 

new users. 

newaliases: ebuild the data ace for the mail 
newfs: construct a new file system. 

news articles. 

news articles. 

news system. 

nextkey: data base sieoutihes: 

NI1010 10 Mb/s Ethernet interface. 

NIC format host tables from a host. 

NIC standard format host tables. 

nice listings of programs. 

nice, nohup: run a command at iow priority 
nice: run low priority process. 

nice: set program priority. 

nlist: get entries from name list. 
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from(1) 
getdisk(3) 
getenv(3) 
getlog(3F) 
getlogin(3) 
getsockname(2) 
mktemp(3) 
pwd(1) 

tty(1) 

hosts(5) 
networks(5) 
protocols(5) 
services(5) 
whois(1) 
getpw(3C) 
nlist(3) 

nm(1) 
symorder(1) 
rename(2) 
ttyname(3) 
ttynam(3F) 
getpeername(2) 
gethostname(2) 
hostnm(3F) 
hostname(1) 
named(8) 
bind(2) 
named(8) 
esh(1) 

term(7) 
ncheck(8) 
uuname(1C) 
ncheck(8) 
eqn(1) 
netstat(1) 
rdump(8C) 
rrestore(8C) 
byteorder(3N) 
getnetent(3N) 


gethostbyname(3N) 


ping(8) 
imp(4) 

lo(4) 

pel(4) 
nsip(4) 
ifconfig(8C) 
slattach(8C) 
networks(5) 
routed(8C) 
netstat(1) 
hy(4) 

ns(4F) 
intro(4N) 
intro(4N) 
networks(5) 
creat(2) 
open(2) 
newfs(8) 
fork(2) 
vfork(2) 
esh(1) 
adduser(8) 
newaliases(1) 
newfs(8) 
readnews(1) 
vnews(1) 
notes(1) 
dbm(3X) 
il(4) 
gettable(8C) 
htable(8) 
verind(1) 
nice(1) 
esh(1) 
nice(3C) 
nlist(3) 
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only). nice, 


setjmp, longjmp: 
bit: and, or, xor, 


notify: request immediate 
biff: be 


ix: Interlan 

np: Interlan 

soelim: eliminate .so’s from 
tbl: format tables for 

colcrt: filter 


troff, 

deroff: remove 

vip: Format Lisp programs to be printed with 
checknr: check 

nsip: software network interface encapsulating 
XNSrouted: 


routines. 

packets in ip packets.. 

ns_addr, 

ns_addr, ns_ntoa: Xerox 
network byte order. htonl, htons, 
order. htonl, htons, ntohl, 


phones: remote host phone 

arithmetic: provide drill in 

rand, srand: random 

random, drandm, irandm: better random 

random, srandom, initstate, setstate: better random 
L-dialcodes: UUCP phone 

atof, atoi, atol: convert ASCII to 

intro: introduction to system calls and error 
number: convert Arabic 

idate, itime: return date or time in 

loc: return the address of an 

long, short: integer 

size: size of an 

lorder: find ordering relation for an 

what: show what versions of 

strings: find the printable strings in a 

index, rindex, Inblnk, len: tell about character 

line discipline for machine-machine communication 
od: 


/pow, gcd, invert, rpow, msqrt, mcmp, move, min, 
/msqrt, mcmp, move, min, omin, fmin, m_in, mout, 


nohup: run a command at low priority (sh 
program file including aliases and paths (csh 
file. open: 

fopen, freopen, fdopen: 

flock: apply or remove an advisory lock on an 
a new file. 

closedir: directory operations. 

syslog, 

cont, point, linemod, space, closepl:/ plot: 
(3X) libraries.. plot: 

savecore: save a core dump of the 

kgmon: generate a dump of the 

intro: introduction to system maintenance and 
tgetstr, tgoto, tputs: terminal independent 
bcopy, bemp, bzero, ffs: bit and byte string 
telldir, seekdir, rewinddir, closedir: directory 
strepy, strncpy, strlen, index, rindex: string 
infnan: signals invalid floating-point 

join: relational database 

curses: screen functions with 

getopt: get 

stty: set terminal 
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nm: print name list. 
nohup: run a command at low Saority Ge. 
nohup: run command immune to hangups. 
non-local goto. : 
not, rshift, Ishift bitwise fancuons: 
notes, autoseq, readnotes: a news system. 
notification. 
notified if mail arrives ‘and who it it is $ from. 
notify: request immediate notification. 
np: Interlan Np100 10 Mb/s Ethernet interface. 
Np100 10 Mb/s Ethernet interface. , 
Np100 10 Mb/s Ethernet interface. 
nroff input. iene sakes 
nroff or troff. tone 
nroff output for CRT previewing. 
nroff: text formatting. 
nroff: text formatting and fypesetine’ 
nroff, troff, tb] and eqn constructs. 
nroff, vtroff, or troff. 
nroff/troff files. 
ns packets in ip packets.. : 
NS Routing Information Protocol aacinon, 
ns: Xerox Network Systems(tm) protocol family. 
ns_addr, ns_ntoa: Xerox NS(tm) address conversion 
nsip: software network interface encapsulating ns 
ns_ntoa: Xerox NS(tm) address conversion routines. 
NS(tm) address conversion routines. : 
ntohl, ntohs: convert values between host and 
ntohs: convert values between host and network byte 
null: data sink. See 
number: convert Arabic anferle ne Euplish: 
number data base. 
number facts. 
number generator. 
number generator. 
number generator; routines for changing generators, 
number index file. 
numbers. 
numbers. 
numerals to English. 
numerical form. 
object. 
object conversion. 
object file. 
object library. 
object modules were ied to construct a file, 
object, or other saad file. 
objects. rs 
(obsolete). bk: 
octal, decimal, hex, ascii dump. 
od: octal, decimal, hex, ascii dump. 
omin, fmin, m_in, mout, omout, fmout, m out, Say J 
omout, fmout, m_out, sdiv, itom: multiple | precision/ 
onintr: process petty in command scripts. 
only). nice, 
only). which: locate a é 
open a file for reading or arin, or create anew 
open a stream. 
open file. Sarit dap 
open: open a file for reading or wating or create 
opendir, readdir, telldir, seekdir, rewinddir, 
openlog, closelog, setlogmask: control system log. 
openpl, erase, label, line, circle, arc, move, 
openpl et al.: {77 library interface to a 
operating system. . 3 
operating system’s profile utters: 
operation commands. 
operation routines. tgetent, ‘peinbins tiettlag. 
operations. 5 
operations. Gpendin vedadie 
operations. strcat, strncat, strcmp, Leencani: 
operations on a VAX (temporary). 
operator. 7 

“‘optimal’’ cursor eur, 
option letter from argv. 
options. 
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nm(1) 
nice(1) 
esh(1) 
setjmp(3) 
bit(3F) 
notes(1) 
csh(1) 
biff(1) 
esh(1) 
np(4) 

ix(4) 

np(4) 
soelim(1) 
tbl(1) 
colcrt(1) 
nroff(1) 
troff(1) 
deroff(1) 
vip(1) 
checknr(1) 
nsip(4) 
XNSrouted(8C) 
ns(4F) 
ns(3N) 
nsip(4) 
ns(3N) 
ns(3N) 
byteorder(3N) 
byteorder(3N) 
null(4) 
number(6) 
phones(5) 
arithmetic(6) 
rand(3C) 
random(3F) 
random(3) 
L-dialcodes(5) 
atof(3) 
intro(2) 
number(6) 
idate(3F) 
loc(3F) 
long(3F) 
size(1) 
lorder(1) 
what(1) 
strings(1) 
index(3F) 
bk(4) 

od(1) 

od(1) 
mp(3X) 
mp(3X) 
esh(1) 
nice(1) 
which(1) 
open(2) 
fopen(3S) 
flock(2) 
open(2) 
directory(3) 
syslog(3) 
plot(3X) 
plot(3F) 
savecore(8) 
kgmon(8) 
intro(8) 
termcap(3X) 
bstring(3) 
directory(3) 
string(3) 
infnan(3M) 
join(1) 
curses(3X) 
getopt(3) 
stty(1) 
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getsockopt, setsockopt: get and set 

ntohs: convert values between host and network byte 
lastcomm: show last commands executed in reverse 
lorder: find 

bessel functions: of two kinds for integer 

vi: screen 

patch: a program for applying a diff file to an 
a.out: assembler and link editor 

terminate a process after flushing any pending 
write, writev: write 

ecvt, fevt, gcvt: 

printf, fprintf, sprintf: formatted 

fold: fold long lines for finite width 

colert: filter nroff 

flush: flush 

foreach: loop 

sendmail: send mail 

trapov: trap and repair floating point 

exec: 

chown: change 

chown: change 

quot: summarize file system 


spp: Xerox Sequenced 

trsp: transliterate sequenced 

network interface encapsulating ns packets in ip 
nsip: software network interface encapsulating ns 
ping: send ICMP ECHO REQUEST 

format: how to format disk 

more, 

getpagesize: get system 

pagesize: print system 

miscellaneous: miscellaneous useful information 


tk: 

swapon: specify additional device for 
drum: 

swapon: add a swap device for interleaved 
socketpair: create a 

me: macros for formatting 

ifconfig: configure network interface 
diskpart: calculate default disk 

pe: 

pxref: 

pdx: 

PXxp: 

pmerge: 

px: 

pix: 


pi: 
chfn, chsh, 
chfn, chsh, 
chfn, chsh, 


getpass: read a 

passwd: 

vipw: edit the 

getpwnam, setpwent, endpwent, setpwfile: get 
chfn, chsh, passwd: change 

chfn, chsh, passwd: change 

chfn, chsh, passwd: change 

mkpasswd: generate hashed 

original. 

getwd: get current working directory 

getcwd: get 

USERFILE: UUCP 

which: locate a program file including aliases and 
grep, egrep, fgrep: search a file for a 

Iptest: generate lineprinter ripple 

awk: 


pel: DEC CSS 
popen, 
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options on sockets. . 2... 6 ee ee ee ee ee getsockopt(2) 
order. htonl,htons,ntohl, ........2...220868- byteorder(3N) 
OLUEES, S00 85 be Bee Meee SE Bal le, Cn AGS tee as ee lastcomm(1) 
ordering relation for an object library, .........-.- lorder(1) 
70) 66 |) kc a a OP ae eS bessel(3F) 
oriented (visual) display editor based onex. .......-. vi(1) 
OTIGIMNAly. gta osha oS. Se er HS Fa we Aa es patch(1) 
OULPUL. 742 BS ae Fe te, Beit aoe a te SEA ee hee a.out(5) 
QUIPUL. EXT oF Wie Rw Re Wee ee i, Sw, ee exit(3) 
OUUPUES Si Sec te sa oe ote a seven eS WE Go Moe LE Se ots eh write(2) 
output conversion. .. 2... ee ee ee ee ee ecvt(3) 
output conversion. .. 2... ee ee ee ee ee ee printf(3S) 
OULPULEVICE:. 52455. eS os Ries Bice Ee oe Sele fold(1) 
output forCRT previewing. .........6.2-+2-. colcrt(1) 
output toalogicalunit. 2... 6. 1 ee eee ee ee flush(3F) 
overlistofnames. ... 1... ee ew ee ee we wwe csh(1) 
overtheinternet. 2... 6. 1 eee ee ee ee sendmail(8) 
OVETHOWs 5 3 ce ye) OTS PO es Ws ee ee Gwe we ah trapov(3F) 
overlay shell with specified command. .......... csh(1) 
OWNERS S25, 4, cae Se Was ve ey a wee ST oe Ser Cok ce RD PFs Tey ee chown(8) 
owner and group ofafile. .........-6.-0280- chown(2) 
OWHELSHIPs, |. sss 4 ei ei erg ewe EL le ke ME OO Rh ete bes OA! quot(8) 
pac: printer/plotter accounting information. ........ pac(8) 
PacketProtocol,,. “soe “ay te eee SAY Se Le ae RO ae as TS spp(4P) 
packet protocoltrace. . 2... 1 ee ee ee ee ee ee trsp(8C) 
packets.. nsip: software ...... 1.5.2.5 eee eee nsip(4) 
packets inip packets. 2... 1... eee ee ee ee ee nsip(4) 
packets to network hosts. . . 6... 2 eee ee ee ee ping(8) 
PACKS: 7, Doyo 3b cos eens ay os, ee eta nese a fe Ye format(8V) 
page: file perusal filter forcrt viewing. .......... more(1) 
PARE SIZE se? xk ciel ce Wee Sie Bee WE Le Gaia's wn ae LS getpagesize(2) 
PAZE SIZES 8 og oe. oe BO eS a RS ee eae EO ae a a pagesize(1) 
PAGES.» ests, sec cee oe. Sa SE o% ociens eo igS a Nd ae “epta g STSt So Tay cared intro(7) 
pagesize: print system page size. . . . 1... ee ee ee pagesize(1) 
paginator for the Tektronix 4014. ..........2.. tk(1) 
paging and swapping. ...... 2. ee eee ee ee swapon(8) 
Paging devices 6. eae. te wee eh tate a Te eh ee drum(4) 
paging/swapping. . 2... 2 eee ee ee ee ee ee swapon(2) 
pair of connected sockets. . 2... 1. ee eee ee ee socketpair(2) 
PAaPeISe> “er ats Te ay te eet eee Me eae ee te weet me(7) 
Parameters; aps Fe hey IE a Re SRE Bie Sw, ifconfig(8C) 
PATtHOM SIZES. 6 oe So ers TR See I , diskpart(8) 
Pascal compiler, - i: sods Ge ea ae eR a pe(1) 
Pascal cross-reference program. . . 2... . ee ee ee pxref(1) 
pascalidébggers  t..5. ce Fe oe eke es Bw A eS ce pdx(1) 
Pascal execution profiler. .......-.4.-4.-8008- pxp(1) 
pascal filésmerger;. 6. s6 oe te ce a ee pmerge(1) 
Pascal interprétef!.° (24. sv 6% eed ees eee eS ae oe px(1) 
Pascal interpreter andexecutor. ........4.-ee80- pix(1) 
Pascal interpreter code translator. .........4240- pi(1) 
passwd: change password file information. . ........ chfn(1) 
passwd: change password file information. . ........ chsh(1) 
passwd: change password file information. . ........ passwd(1) 
passwd: password file. 2... 2 2 ee ee ee ee ee ee passwd(5) 
PASSWOLS» chris ass Gh OES Sa OR te NE Se Rw Bal, Woe SOIR getpass(3) 
password file. <.oc4$c-62 eek Se ee a we passwd(5) 
PaSSWOrd files | wea wise Sa, ce cee: We, Eel sel oa ae os vipw(8) 
password file entry. getpwent, getpwuid, ......... getpwent(3) 
password fileinformation, ..........6.-000- chfn(1) 
password fileinformation. ........4..6.2-006- chsh(1) 
password fileinformation, .........2.-62 5280 - passwd(1) 
passwordtable. 6 6 ww ee ee ee ee ee mkpasswd(8) 
patch: a program for applyingadifffiletoan ........ patch(1) 
pathname; ss aS es oe ew LG eee Als getwd(3) 
pathname of current working directory. .........- getcwd(3F) 
pathname permissions file. . 2... 6. 2 ee ee eee USERFILE(5) 
paths. (cshonly), 606 see OE ee A which(1) 
Patterns Lay 6's Te he SE a eee ce Bh Ecole Ww Ae grep(1) 
Patlerts ay i cay ee ate ate Lb ee el ee ee ees Iptest(1) 
pattern scanning and processing language. . ........ awk(1) 
pause: stopuntilsignal. . 2... ew ee eee ee ee pause(3C) 
pe: Pascalcompiler: . 26. ik OA wee a pe(1) 
pel: DEC CSS PCL-11 B Network Interface. . 2... 2. pel(4) 
PCL-11 B Network Interface. . . 2... 4... 2 ee ee pel(4) 
pclose: initiate I/O to/from a process. . 2... 2. ee eee popen(3) 
pdx: pascaldebugger. . 2. 2... 2 ee ee ee eee pdx(1) 
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getpeername: get name of connected 

exit: terminate a process after flushing any 
L.cmds: UUCP remote command 
USERFILE: UUCP pathname 

mesg: 

ptx: 

limit: alter 


messages. 
sticky: 

more, page: file 
phones: remote host 
L-dialcodes: UUCP 


hosts. 


move, cont, point, linemod, space, closepl:/ 
plot (3X) libraries.. 


trpfpe, fpecnt: trap and repair floating 
/erase, label, line, circle, arc, move, cont, 
trapov: trap and repair floating 

lseek: move read/write 

dmc: DEC DMC-11/DMR-11 

uupoll: 


popd: 


ttynam, isatty: find name of a terminal 

exp, expm1, log, log10, log1p, 

omin, fmin, m_in, mout,/ madd, msub, mult, mdiv, 
log, log10, log1p, pow: exponential, logarithm, 


mout, omout, fmout, m_out, sdiv, itom: multiple 
monitor, monstartup, moncontrol: 
colcrt: filter nroff output for CRT 
types: 

cat: catenate and 

Ipr: off line 

fortune: 

date: 

cal: 

hashstat: 

jobs: 

whoami: 

pr: 

fpr: 

history: 

hostid: set or 

banner: 

nm: 

hostname: set or 

printenv: 

man: find manual information by keywords; 
pstat: 

pagesize: 

atq: 

diction, explain: 

file. strings: find the 


vlp: Format Lisp programs to be 


banner: print large banner on 


4.3BSD 


: phototypesetter interface. 


: pipe fitting. 


: place job in background. 
: play ‘‘Go Fish’’. 

: play Mille Bournes. 
: play the game of boggle. 
: Play the growing worm game. 


peer. 
pending output. 
permissions file. 
permissions file. 
permit or deny messages. 
permuted index. 
per-process resource limitations. 
perror, gerror, ierrno: get system error messages. 
perror, sys_errlist, sys_nerr: system error 

persistent text and append-only directories. 
perusal filter for crt viewing. 
phone number data base. 
phone number index file. 
phones: remote host phone number data base. 


photoypesetter simulator. 
pi: Pascal interpreter code translator. 
Picture System 2 graphics device interface. 
ping: send ICMP ECHO_REQUEST packets to network 
pipe: create an interprocess communication channel. 


pix: Pascal interpreter andexecutor. ........4..-. 
plot: graphics filters. 
plot: graphics interface. 
plot: openpl, erase, label, line, circle, arc, 
plot: openpl et al.: {77 library interface to 
pmerge: pascal file merger. 
point faults. 
point, linemod, space, closepl: graphics interface. 
point overflow. 
pointer. 
point-to-point communications device. 
poll a remote UUCP site. 
pop shell directory stack. 
popd: pop shell directory stack. 
popen, pclose: initiate I/O to/from a process. 
port. 
pow: exponential, logarithm, power. 
pow, gcd, invert, rpow, msqrt, mcmp, move, min, 
power. exp, expm1, 
pr: print file. 
precision integer arithmetic. /omin, fmin, m_in, 
prepare execution profile. 
previewing. 
primitive system data types. 
print. 
print. 
print a random, hopefully interesting, adage. 
print and set the date. 
print calendar. 
print command hashing statistics. 
print current job list. 
print effective current user id. 
print file. 
print Fortran file. 
print history event list. 
print identifier of current host system. 
print large banner on printer. 
print name list. 
print name of current host system. 
print out the environment. 
print out the manual. 
print system facts. 
print system page size. 
print the queue of jobs waiting to be run. 
print wordy sentences; thesaurus for diction. 
printable strings in a object, or other binary, 
printcap: printer capability data base. 
printed with nroff, vtroff, or troff. 
printenv: print out the environment. 
printer. 
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getpeername(2) 
exit(3) 
L.cmds(5) 
USERFILE(5) 
mesg(1) 
ptx(1) 
csh(1) 
perror(3F) 
perror(3) 
sticky(8) 
more(1) 
phones(5) 
L-dialcodes(5) 
phones(5) 
ct(4) 

te(1) 

pi(1) 

ps(4) 
ping(8) 
pipe(2) 
tee(1) 
pix(1) 
esh(1) 
fish(6) 
mille(6) 
boggle(6) 
worm(6) 
plot(1G) 
plot(5) 
plot(3X) 
plot(3F) 
pmerge(1) 
trpfpe(3F) 
plot(3X) 
trapov(3F) 
lseek(2) 
dmc(4) 
uupoll(8C) 
esh(1) 
esh(1) 
popen(3) 
ttynam(3F) 
exp(3M) 
mp(3X) 
exp(3M) 
pr(1) 
mp(3X) 
monitor(3) 
colcrt(1) 
types(5) 
cat(1) 
Ipr(1) 
fortune(6) 
date(1) 
cal(1) 
esh(1) 
csh(1) 
whoami(1) 
pr(1) 

fpr(1) 
esh(1) 
hostid(1) 
banner(6) 
nm(1) 
hostname(1) 
printenv(1) 
man(1) 
pstat(8) 
pagesize(1) 
atq(1) 
diction(1) 
strings(1) 
printcap(5) 
vip(1) 
printenv(1) 
banner(6) 
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Ip: line 

printcap: 

Ipe: line 

Ipd: line 

Iprm: remove jobs from the line 
pac: 

conversion. 

setpriority: get/set program scheduling 
nice: set program 

nice, nohup: run a command at low 
renice: alter 

nice: run low 

adduser: 

reboot: UNIX bootstrapping 
nice: run low priority 

stop: halt a job or 

_exit: terminate a 

fork: create a new 

fork: create a copy of this 
implogd: IMP logger 

kill: send signal to a 

kill: send a signal to a 

popen, pclose: initiate I/O to/from a 
wait: await completion of 

exit: terminate a 

init: 

getpgrp: get 

killpg: send signal to a 

setpgrp: set 

getpid: get 

getpid, getppid: get 

vfork: spawn new 

onintr: 

ps: 

times: get 

wait, wait3: wait for 

wait: wait for a 

ptrace: 

kill: terminate a 

exit: terminate 

kill: kill jobs and 

gcore: get core images of running 
renice: alter priority of running 
wait: wait for background 

awk: pattern scanning and 

halt: stop the 

m4: macro 

reboot: reboot system or halt 


monitor, monstartup, moncontrol: prepare execution 
profil: execution time 

kgmon: generate a dump of the operating system’s 
gprof: display call graph 

prof: display 

pxp: Pascal execution 

drtest: standalone disk test 

end, etext, edata: last locations in 

finger: user information lookup 

ftp: ARPANET file transfer 

liszt: compile a Franz Lisp 

Ipc: line printer control 

Ipq: spool queue examination 

Ixref: lisp cross reference 

msgs: system messages and junk mail 

mt: magnetic tape manipulating 

pxref: Pascal cross-reference 

rdist: remote file distribution 

tftp: trivial file transfer 

timedc: timed control 

units: conversion 

whereis: locate source, binary, and or manual for 
cb: C 

only). which: locate a 

patch: a 

make: maintain 
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PTINter: 8255, Ge cag ess Me RS ce RT ce Ip(4) 
printer capability database. . . 2... 1... 2 ee eee printcap(5) 
printer control program. .... 2... +. eee eee Ipe(8) 
Printer'dacmonis. 15. sense OR. Secigttan et @ Se Gta sd ee esis Ipd(8) 
printer spooling queue. .......-..+4 2.52 eee Iprm(1) 
printer/plotter accounting information. .......... pac(8) 
printf, fprintf, sprintf: formatted output .......... printf(3S) 
Priority. setpriority, i ee Se a ee Oe et getpriority(2) 
PHIOrityy. WSS, ee yes IS eh ae Is Saha oe te, Se, oes nice(3C) 
priority (shonly),  ... 2... 2.56 22 ee eee eee nice(1) 
priority of running processes. . . 2... 2 ee ee ee ee renice(8) 
PTIOTity:PLOCESS: is ee way ee ee Wee Ss aR ey BO, ee csh(1) 
procedure for adding new users. . .. 2... ee. ee eee adduser(8) 
PLOCECUIES 6 <o ss! GOS eS Mee ee A Ge one Se reboot(8) 
PLOCESS sos Ga ee EE ne I EU Me es EE esh(1) 
PIOCESSs. Ye. hee Se eS co ees ee Bice eS oes esh(1) 
PLOCESS:.. oA. cae os cays Be Seed Lea tel oe eel we CAST OR ad exit(2) 
PLOCESS:.. ws CG ele ES GEREN ta es. LS BS fork(2) 
PIOCESS:.. duties Bitaierds wre) BME ee AY Sh a fork(3F) 
PIOCESS).. <4 4%. Rg ead ise a. Bi ce Getta el es A. Ge wast I Bets implogd(8C) 
PLOCESS2 2-55 oe 20h SP eke eG Valet Gal ee See Se ete Le kill(2) 
PIOCESS:.. date RE its es Hy a) EE oe BO she we kill(3F) 
PLOCESSs-. - 55 6s JS se ig Ba, Seg dence OR STN Go OD te te OS popen(3) 
PLOCESS:, niga ee OEE atte San ta UBD ot ah ae Ga ae EE A ee Goi Te wait(1) 
process after flushing any pending output. . ........ exit(3) 
process controlinitialization, ..........2.20+.- init(8) 
PLOCESSSTOUP:, 62 S206) Ge sek SEAS Medel ges epee le LS getpgrp(2) 
PLOCESS: SOUPS a. Foe ns 8, ee SS nee Bas Ee eee os lee oe killpg(2) 
PLOCESS SOUPS? 56 ee ee ce HRS ee Se Be i eR setpgrp(2) 
PLOCESSAG.. os eee Bk ea nek So ede, GEE BEES ee getpid(3F) 
process identification, . ... 1... 2... ee ee eee getpid(2) 
process in a virtual memory efficient way. ......... vfork(2) 
process interrupts in command scripts. .......... csh(1) 
process status. 2. 6. 6 1 1 ee ee ee ee ee eee ps(1) 
Process:imes: Os” iets 285 ee A, sie Me ea teied eee A times(3C) 
processtoterminate. ........- 2.52. ee eee wait(2) 
processtoterminate. . . 2... ee ee eee ee eee wait(3F) 
PLOcess tace.~ «221s See eee ee Std Be ce. Ae ptrace(2) 
process with extreme prejudice. . .......-. 22s kill(.) 
process with status. 06% ce i ee ak ea ee ee exit(3F) 
PTOCESSES: ceed idee TE a, RO Ree IR RE Bie Sow, oe ee csh(1) 
PIOGESSES. 2 m8 oo. ss OS ae ere SS ne ei vs, OI et es gcore(1) 
PLOCESSES, yds: SSNS a at. Seba Ge we Ge Ee renice(8) 
processes tocomplete. . . 1... 2... eee eee eee csh(1) 
processing language. . ... 1... ee ee ee ee ee awk(1) 
PLOCESSOR, 6 see eee ee Ges ceed ead Ae eo ete Se halt(8) 
PTOCESSOF:. 9.6 Ge oS eee ee ne Se a eae LS cs m4(1) 
PLOCESSOLA Ae SHS So etcst ees Pre eS ees reboot(2) 
prof: display profiledataa ..........6.-420.6- prof(1) 
profil: execution time profile. .............. profil(2) 
profiles 26 sd. 2s. a ile. tee as a Be date. BO Beets bas OA! monitor(3) 
Profiles ie se eee BE Ne ook OD eS Ht TR we Ae OS profil(2) 
profile buffers. <2 e008 vey oe Gees Re coh ie EE ate ea Bs kgmon(8) 
profile:datay. ..05 6. Si ase Seal oe See Se SE See SE owl oe FE gprof(1) 
profile datas: ics hc ee Sel Ie NE Bw Ba ee prof(1) 
PLOREE: née doe OE a eek eg a ee pxp(1) 
PLOSTAM, Sk wee kneels oa, Cee SW ney Wa we ES eee oa ee drtest(8) 
PLOSTAM LS! ist sa ee set se es de a Rae ea ee fe aN RS end(3) 
PLOSTAM. 85 fe Sele eB See te ne GE Ea Se finger(1) 
PLOStamM.. <5 oF coy vee be wee OH ae eee ae Ea ee eS a ftp(.C) 
Prostamiz” <7 oe oO. tee ga ate fee EE. ae ae liszt(1) 
PLOStAMs,. “5 pce cg. eS els Sv ei oe. cb tS Ss oe “ape ke. tea Ss 4 Tey coed Ipc(8) 
PLOstam. <5 6. eh sR eo Sk a we he eS Ipq(1) 
PLOStaM:. “ss % i ihe a3 eA le Ne ete oie dea Ixref(1) 
PLOBTAM.. 5 Mer con 8S tates ve Se ceetg ten let | “Sree de. HRS? HH Bee cerns msgs(1) 
PLOSCAM sy ce, -S> eee Lene Ae Me eee tate ox Te. Se cae bee at A te wee i be mt(1) 
PrOstams. “s.%te we ce SA aS ee UE ce ws pxref(1) 
program... «ra wel ete eee le Maer se aces rdist(1) 
Prostate, 624 Pe te eek a Dee eek tftp(1C) 
PLOStam, 4 pe F Wisp lS a UE Ree RE Bee Sow, ee ve timedc(8) 
PLOSTAM 65 55 8S sil ww Fo a rere TS oh To Ms ete units(1) 
PLOSTAM: fees eS ee a es a ES whereis(1) 
program beautifier, . 2... 1... eee ee ee ee ee cb(1) 
program file including aliases and paths (csh «7... ee which(1) 
program for applying a diff fileto anoriginalh . ...... patch(1) 
program groups. . 2... 6 ee ee ee ee we ee ee make(1) 
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nice: set 

getpriority, setpriority: get/set 
indent: indent and format C 

assert: 

lint: aC 

fp: Functional 

lex: generator of lexical analysis 
struct: structure Fortran 

verind: grind nice listings of 

troff. vlp: Format Lisp 

xstr: extract strings from C 

vv: Proteon 

vv: 

arp: Address Resolution 

icmp: Internet Control Message 
idp: Xerox Internet Datagram 

ip: Internet 

spp: Xerox Sequenced Packet 

tcp: Internet Transmission Control 
telnet: user interface to the TELNET 
udp: Internet User Datagram 
XNSrouted: NS Routing Information 
getprotobyname, setprotoent, endprotoent: get 
inet: Internet 

ns: Xerox Network Systems(tm) 
rmt: remote magtape 

protocols: 

ftpd: DARPA Internet File Transfer 
telnetd: DARPA TELNET 

tftpd: DARPA Trivial File Transfer 
trpt: transliterate 

trsp: transliterate sequenced packet 


mkproto: construct a 
arithmetic: 
false, true: 
true, false: 

device interface. 


pty: 


doctor: interact with a 


ungetc: 
pushd: 


puts, fputs: 

putc, putchar, fputc, putw: 
unit. 

on a stream. 

stream. putc, 


putc, putchar, fputc, 


qe: DEC DEQNA 


insque, remque: insert/remove element from a 
Iprm: remove jobs from the line printer spooling 
uuq: examine or manipulate the uucp 

Ipq: spool 

atq: print the 

uucico, uucpd: transfer files 

qsort: 

qsort: 


quotacheck: file system 
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program priority. 
program scheduling priority. 
program source. 
program verification. 
program verifier. 
Programming language compiler/interpreter. 
programs. 
programs. 
programs. 
programs to be printed with nroff, vtroff, or 
programs to implement shared strings. 
proNET 10 Megabit ring. 
Proteon proNET 10 Megabit ring. 
Protocol. 
Protocol. 
Protocol. 
Protocol. 
Protocol. 
Protocol. 
protocol. 
Protocol. 
Protocol daemon. 
protocol entry. getprotoent, getprotobynumber, 
protocol family. 
protocol family. 
protocol module. 
protocol name data base. 
Protocol server. 
protocol server. 
Protocol server. 
protocol trace. 
protocol trace. 
protocols: protocol name data base. 
prototype file system. 
provide drill in number facts. 
provide truth values. 
provide truth values. 
ps: Evans and Sutherland Picture System 2 graphics 
ps: process status. 
pseudo terminal driver. 
psignal, sys_siglist: system signal messages. 
pstat: print system facts. 
psychoanalyst. 
ptrace: process trace. 
ptx: permuted index. 
pty: pseudo terminal driver. 
push character back into input stream. 
push shell directory stack. 
pushd: push shell directory stack. 
put a string on a stream. 
put character or word on a stream. 
putc, fputc: write a character to a fortran logical 
putc, putchar, fputc, putw: put character or word 
putchar, fputc, putw: put character or word on a 
puts, fputs: put a string on a stream. 
putw: put character or word on a stream. 
pwd: working directory name. 
px: Pascal interpreter. 
pxp: Pascal execution profiler. 
pxref: Pascal cross-reference program. 
Q-bus 10 Mb/s Ethernet interface. 
qe: DEC DEQNA Q-bus 10 Mb/s Ethernet interface. 
qsort: quick sort. 
qsort: quicker sort. 
queue. 


queue. 
queue examination program. 
queue of jobs waiting to be run. 
queued by uucp or uux. 
quick sort. 
quicker sort. 
quiz: test your knowledge. 
quot: summarize file system ownership. 
quota consistency checker. 
quota: display disc usage and limits. 


- lix - 


nice(3C) 
getpriority(2) 
indent(1) 
assert(3) 
lint(1) 

fp(1) 

lex(1) 
struct(1) 
verind(1) 
vip(1) 
xstr(1) 

vv(4) 

vv(4) 
arp(4P) 
icmp(4P) 
idp(4P) 
ip(4P) 
spp(4P) 
tcp(4P) 
telnet(1C) 
udp(4P) 
XNSrouted(8C) 
getprotoent(3N) 
inet(4F) 
ns(4F) 
rmt(8C) 
protocols(5) 
ftpd(8C) 
telnetd(8C) 
tftpd(8C) 
trpt(8C) 
trsp(8C) 
protocols(5) 
mkproto(8) 
arithmetic(6) 
false(1) 
true(1) 

ps(4) 


psignal(3) 
pstat(8) 
doctor(6) 
ptrace(2) 
ptx(1) 
pty(4) 
ungetc(3S) 
csh(1) 
esh(1) 
puts(3S) 
putc(3S) 
putc(3F) 
putc(3S) 
putc(3S) 
puts(3S) 
putc(3S) 
pwd(1) 
px(1) 


qe(4) 
qsort(3F) 
qsort(3) 
insque(3) 
Iprm(1) 
uuq(1C) 
Ipq(1) 

atq(1) 
uucico(8C) 
qsort(3F) 
qsort(3) 
quiz(6) 
quot(8) 
quotacheck(8) 
quota(1) 
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quotaon, 

off. 

edquota: edit user 

quota: manipulate disk 

repquota: summarize 

setquota: enable/disable 

quotaon, quotaoff: turn file system 


rain: animated 


generator. 

fortune: print a 

ranlib: convert archives to 

rand, srand: 

random, drandm, irandm: better 

random, srandom, initstate, setstate: better 
number generator; routines for changing/ 
rand, drand, irand: return 


ratfor: 
imp: IMP 


stream to a remote command. 


rcsintro: introduction to 


getpass: 

source: 

read, readv: 

readnews: 

vnews: 

/continue, cd, eval, exec, exit, export, login, 


readlink: 
directory operations. opendir, 
open: open a file for 


notes, autoseq, 

command/ /cd, eval, exec, exit, export, login, read, 
read, 

bad144: 

lseek: move 

setregid: set 

setreuid: set 

malloc, free, 

symorder: 


reboot: 


fastboot, fasthalt: 
newaliases: 

recy, recvfrom, recvmsg: 
mail: send and 
binmail: send or 

rmail: handle remote mail 


rehash: 

utmp, wtmp: login 

socket. 

recy, 

recv, recvfrom, 

eval: 

re_comp, 

documents. 

bibliographic formatter; list bibliographic 
Ixref: lisp cross 

build inverted index for a bibliography, find 
refer: find and insert literature 

re_comp, re_exec: 
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quota: manipulate disk quotas. 

quotacheck: file system quota mousistetiey check. 
quotaoff: turn file system quotas on and off. 
quotaon, quotaoff: turn file system quotas on and 
quotas. 

quotas. . 

quotas for a file syste 

quotas on a file system. 

quotas on and off. 

rain: animated raindrops display. 

raindrops display. 

rand, drand, irand: return adem values, 

rand, srand: random number generator. 

random, drandm, irandm: better random meres 
random, hopefully interesting, adage. 

random libraries. 

random number generator. 

random number generator. é 

random number generator; routines for changine) 
random, srandom, initstate, setstate: better random 
random values. 

ranlib: convert archives to ‘haem fiiratics 
ratfor: rational Fortran dialect. 

rational Fortran dialect. 

raw socket interface. 

rc: command script for auto- rehoae and daemons, 
rcmd, rresvport, ruserok: routines for returning a 
rcp: remote file copy. 

RCS commands. 

resintro: introduction to RCS commande. 

rdist: remote file distribution program. 

rdump: file system dump across the network. 
read a password. 

read commands from file. 

read input. 

read news articles. 

read news articles. 

read, readonly, set, shift, ‘ines, trad, anaes / 
read, readv: read input. 

read value of a symbolic link. SN te 
readdir, telldir, seekdir, rewinddir, ciosedir: 
reading or writing, or create a new file. 

readlink: read value of a symbolic link. 
readnews: read news articles. 

readnotes: a news system. 

readonly, set, shift, times, trap, vihiraske wait: 
readv: read input. 

read/write dec standard 144 bad: sector infouration: 
read/write pointer. 

real and effective group ID. 

real and effective user ID’s. 

realloc, calloc, alloca: memory allseaton 
rearrange name list. fi 

reboot: reboot system or halt processor. 

reboot system or halt processor. 

reboot: UNIX bootstrapping procedures. , 
reboot/halt the system without checking the disk. 
rebuild the data base for the mail aliases file. 
receive a message from a socket. 

receive mail. 

receive mail among users. 

received via uucp. > 
re_comp, re_exec: regular dxiiession "handler. 
recompute command hash table. 

records. bald eet ee ae ss ee cals 
recv, recvfrom, recvmsg: receive a message froin a 
recvfrom, recvmsg: receive a message from a socket. 
recvmsg: receive a message from a socket. 
re-evaluate shell data. at 
re_exec: regular expression handles: 

refer: find and insert literature references in 
reference items. bib, listrefs: 

reference program. 

references ina hibligeraphy, isidgbib, 1eskebiby" 
references in documents. 3 ote 
regular expression handler. 
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quota(2) 
quotacheck(8) 
quotaon(8) 
quotaon(8) 
edquota(8) 
quota(2) 
repquota(8) 
setquota(2) 
quotaon(8) 
rain(6) 
rain(6) 
rand(3F) 
rand(3C) 
random(3F) 
fortune(6) 
ranlib(1) 
rand(3C) 
random(3F) 
random(3) 
random(3) 
rand(3F) 
ranlib(1) 
ratfor(1) 
ratfor(1) 
imp(4P) 
re(8) 
remd(3) 
rep(1C) 
resintro(1) 
resintro(1) 
rdist(1) 
rdump(8C) 
getpass(3) 
esh(1) 
read(2) 
readnews(1) 
vnews(1) 
sh(1) 
read(2) 
readlink(2) 
directory(3) 
open(2) 
readlink(2) 
readnews(1) 
notes(1) 
sh(1) 
read(2) 
bad144(8) 
lseek(2) 
setregid(2) 
setreuid(2) 
malloc(3) 
symorder(1) 
reboot(2) 
reboot(2) 
reboot(8) 
fastboot(8) 
newaliases(1) 
recv(2) 
mail(1) 
binmail(1) 
rmail(1) 
regex(3) 
esh(1) 
utmp(5) 
recv(2) 
recv(2) 
recv(2) 
esh(1) 
regex(3) 
refer(1) 
bib(1) 
Ixref(1) 
lookbib(1) 
refer(1) 
regex(3) 
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comm: select or 

lorder: find ordering 

join: 

sigpause: atomically 

strip: remove symbols and 
copysign, drem, finite, logb, scalb: copysign, 
leave: 

calendar: 

ruserok: routines for returning a stream to a 
rexec: return stream to a 
L.cmds: UUCP 

rexecd: 

rep: 

rdist: 

uusend: send a file toa 
L.sys: UUCP 

remote: 

phones: 

rlogin: 

rlogind: 

tn3270: full-screen 

rmt: 

rmail: handle 


rsh: 

rshd: 

tip, cu: connect to a 
talkd: 

fingerd: 
uupoll: poll a 
unlink: 

rmdir: 

unalias: 

flock: apply or 
colrm: 

unlink: 
unsetenv: 
mount, umount: mount or 
unifdef: 

Iprm: 

atrm: 

deroff: 
unlimit: 

strip: 

rmdir, rm: 

rm, rmdir: 
insque, 
rename: 


mv: move or 


fsck: file system consistency check and interactive 
trpfpe, fpecnt: trap and 

trapov: trap and 

while: 


uniq: report 

repeat: execute command 
yes: be 

iostat: 

uniq: 

sendbug: mail a system bug 
vmstat: 

bugfiler: file bug 

fseek, ftell: 

fseek, ftell, rewind: 


notify: 
lock: 
res mkquery, res_send, 


rehash: recompute command hash table. 
reject lines common to two sorted files. 
relation for an object library. 

relational database operator. 

release blocked signals and wait for qnientupt, 
relocation bits. 

remainder, exponent ianipuledous: 
remind you when you have to leave. 
reminder service. 

remote command. rcmd, eseport: 
remote command. ‘ 
remote command permissions file. 
remote execution server. 

remote file copy. : 
remote file distribution program. 
remote host. 

remote host description file. 

remote host description file. 

remote host phone number data base. 
remote login. 

remote login server. . . 

remote login to IBM VMICMS. 

remote magtape protocol module. 
remote mail received via uucp. 

remote: remote host description file. 
remote shell. 

remote shell server. 

remote system. : 
remote user eomnmmenication server. 
remote user information server. 

remote UUCP site. 

remove a directory entry. 

remove a directory file. 

remove aliases. 

remove an advisory Tock on an open wails. 
remove columns from a file. 

remove directory entry. 

remove environment variables. 

remove file system. 

remove ifdef’ ed lines. 


remove jobs from the line prin spooling queue. 


remove jobs spooled by at. é 
remove nroff, troff, tbl and eqn coneinets, 
remove resource limitiations. . 
remove symbols and relocation bits. 
remove (unlink) directories or files. 
remove (unlink) files or directories. 
remque: insert/remove element from a queue, 
rename a file. A 
rename: change the name ee a rales 

rename files. 

rename: rename a file. 
renice: alter priority of running processes. 
repair. St 

repair floating soit “faults. 

repair floating point overflow. 

repeat commands conditionally. 

repeat: execute command repeatedly. 
repeated lines in a file. 

repeatedly. : 

repetitively abarmative: 

report I/O statistics. : 

report repeated lines in a file. 

report to 4bsd-bugs. : 

report virtual memory Statistics: 

reports in folders automatically. 

reposition a file on a logical unit. 
reposition a stream. 

repquota: summarize qudtas ae a file eysicta: 
request immediate notification. 

reserve a terminal. 

res init, dn_comp, dn_expand: fesolvers routines. 


dn_expand: resolver routines. 
arp: address 
arp: Address 
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res_mkquery, res_send, res init, dn_comp, 
resolution display and control. 

Resolution Protocol. 

resolver configuration file. 
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csh(1) 
comm(1) 
lorder(1) 
join(1) 
sigpause(2) 
strip(1) 
ieee(3M) 
leave(1) 
calendar(1) 
remd(3) 
rexec(3) 
L.cmds(5) 
rexecd(8C) 
rep(1C) 
rdist(1) 
uusend(1C) 
L.sys(5) 
remote(5) 
phones(5) 
rlogin(1C) 
rlogind(8C) 
tn3270(1) 
rmt(8C) 
rmail(1) 
remote(5) 
rsh(1C) 
rshd(8C) 
tip(1C) 
talkd(8C) 
fingerd(8C) 
uupoll(8C) 
unlink(3F) 
rmdir(2) 
esh(1) 
flock(2) 
colrm(1) 
unlink(2) 
esh(1) 
mount(2) 
unifdef(1) 
Iprm(1) 
atrm(1) 
deroff(1) 
csh(1) 
strip(1) 
rmdir(1) 
rm(1) 
insque(3) 
rename(3F) 
rename(2) 
mv(1) 
rename(3F) 
renice(8) 
fsck(8) 
trpfpe(3F) 
trapov(3F) 
esh(1) 
esh(1) 
uniq(1) 
esh(1) 
yes(1) 
iostat(1) 
uniq(1) 
sendbug(1) 
vmstat(1) 
bugfiler(8) 
fseek(3F) 
fseek(3S) 
repquota(8) 
esh(1) 
lock(1) 
resolver(3) 
resolver(3) 
arp(8C) 
arp(4P) 
resolver(5) 
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res_send, res init, dn_ comp, dn_expand: 
getrlimit, setrlimit: control maximum system 
vlimit: control maximum system 

limit: alter per-process 

unlimit: remove 

getrusage: get information about 

vtimes: get information about 

routines. res_mkquery, 

restore: incremental file system 

rrestore: 


suspend: suspend a shell, 

mset: 

getarg, iarge: 

fdate: 

idate, itime: 

etime, dtime: 

fimin, flmax, ffrac, dflmin, dflmax, dffrac, inmax: 
sigreturn: 

vacation: 

rand, drand, irand: 

rexec: 

time, ctime, ltime, gmtime: 

loc: 
rcmd, rresvport, ruserok: routines for 


col: filter 

rev: 

lastcomm: show last commands executed in 
fseek, ftell, 

opendir, readdir, telldir, seekdir, 


index, 

strcmp, strncmp, strcpy, strncpy, strlen, index, 
vv: Proteon proNET 10 Megabit 
round-to-nearest functions. fabs, floor, ceil, 
Iptest: generate lineprinter 

hk: RK6-11/RK06 and 

hk: 

crl: VAX 8600 console 


rmdir, 


rm, 


robots: fight off villainous 


cbrt, sqrt: cube root, square 

chroot: change 

cbrt, sqrt: cube 

ceil, rint: absolute value, floor, ceiling, and 


inet_netof: Internet address manipulation 

ns_addr, ns_ntoa: Xerox NS(tm) address conversion 
res_send, res init, dn comp, dn_expand: resolver 
tgoto, tputs: terminal independent operation 
setstate: better random number generator; 
command. rcmd, rresvport, ruserok: 

routed: network 

XNSrouted: NS 

route: manually manipulate the 

mout,/ madd, msub, mult, mdiv, pow, gcd, invert, 
network. 

to aremote command. rcmd, 


bit: and, or, xor, not, 
atq: print the queue of jobs waiting to be 
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resolver routines. res_mkquery, 

resource consumption. 

resource consumption. 

resource limitations. 

resource limitiations. 

resource utilization. 

resource utilization. F 
res_send, res init, dn_comp, dy “Sapaud: pesoiver 
restore. . 
restore a file sy eiein aumpea across vine wietnoek. 
restore: incremental file system restore. 
resuming its superior. . . 

retrieve ASCII to IBM 3270 keyboard m map. 
return command line arguments. 

return date and time in an ASCII string. 

return date or time in numerical form. 

return elapsed execution time. 

return extreme values. 

return from signal. aE aEC 

return ‘‘I am on vacation’’ indication. 

return random values. 

return stream to a remote benimnatids 

return system time. 

return the address of an abject. 

returning a stream to a remote command. 

rev: reverse lines of a file. 

reverse line feeds. 

reverse lines of a file. 

reverse order. é 

rewind: reposition a stream, . 
rewinddir, closedir: directory Gpaanons, 

rexec: return stream to a remote command. 
rexecd: remote execution server. . 
rindex, Inblink, len: tell about character obises 
rindex: string operations. strcat, strncat, 

ring. F 

rint: eheoluic values ees ailbiips ant 

ripple pattern. . . 

RKO7 moving head disc. Sas : 
RK6-11/RK06 and RKO7 moving head disk. , 
RLO2 interface. rar Zo doeGecs, Se 
rlogin: remote login. 

rlogind: remote login server. , 

rm: remove (unlink) directories or fies 

rm, rmdir: remove (unlink) files or directories. 
rmail: handle remote mail received via uucp. 
rmdir: remove a directory file. F 
rmdir: remove (unlink) files or directories. 
rmdir, rm: remove (unlink) directories or files. 
rmt: remote magtape protocol module. 

robots. 

robots: fight off sllaiibis rabble: 

roffbib: run off bibliographic database. 

rogue: Exploring The Dungeons of Doom. 
root. 

root directory. 

root, square root. 7 
round-to-nearest functions. fae. floss, 

route: manually manipulate the routing tables. 
routed: network routing daemon. ; 
routines. /inet_ntoa, inet_makeaddr, inet _Inaof, 
routines. 

routines. res | mkquery, 

routines. tgetent, tgetnum, Epettlag, ‘sets, 
routines for changing generators. /initstate, 
routines for returning a stream to a remote 
routing daemon. 

Routing Information Bebreal aacnion. 

routing tables. 


rpow, msqrt, mcmp, move, min, omin, ae m_in, 


rrestore: restore a file system dump across the 
rresvport, ruserok: routines for returning a stream 
rsh: remote shell. 

rshd: remote shell server. 

rshift, lshift bitwise functions. 

run. 
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resolver(3) 
getrlimit(2) 
vlimit(3C) 
esh(1) 
esh(1) 
getrusage(2) 
vtimes(3C) 
resolver(3) 
restore(8) 
rrestore(8C) 
restore(8) 
csh(1) 
mset(1) 
getarg(3F) 
fdate(3F) 
idate(3F) 
etime(3F) 
fimin(3F) 
sigreturn(2) 
vacation(1) 
rand(3F) 
rexec(3) 
time(3F) 
loc(3F) 
remd(3) 
rev(1) 
col(1) 
rev(1) 
lastcomm(1) 
fseek(3S) 
directory(3) 
rexec(3) 
rexecd(8C) 
index(3F) 
string(3) 
vv(4) 
floor(3M) 
Iptest(1) 
hk(4) 

hk(4) 

crl(4) 
rlogin(1C) 
rlogind(8C) 
rmdir(1) 
rm(1) 
rmail(1) 
rmdir(2) 
rm(1) 
rmdir(1) 
rmt(8C) 
robots(6) 
robots(6) 
roffbib(1) 
rogue(6) 
sqrt(3M) 
chroot(2) 
sqrt(3M) 
floor(3M) 
route(8C) 
routed(8C) 
inet(3N) 
ns(3N) 
resolver(3) 
termcap(3X) 
random(3) 
remd(3) 
routed(8C) 
XNSrouted(8C) 
route(8C) 
mp(3X) 
rrestore(8C) 
remd(3) 
rsh(1C) 
rshd(8C) 
bit(3F) 
atq(1) 
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nice, nohup: 

nohup: 

nice: 

roffbib: 

gcore: get core images of 


renice: alter priority of 

remote command. rcmd, rresvport, 
rx: DEC 

savecore: 

brk, 


copysign, drem, finite, logb, 
scandir, alphasort: 


awk: pattern 


sccs: front end for the 

alarm: 

ualarm: 

getpriority, setpriority: get/set program 
clear: clear terminal 

curses: 

eX. Vi: 

rc: command 


onintr: process interrupts in command 

/min, omin, fmin, m_in, mout, omout, fmout, m_out, 
grep, egrep, fgrep: 

xsend, xget, enroll: 

bad144: read/write dec standard 144 bad 

badsect: create files to contain bad 


opendir, readdir, telldir, 
brk, sbrk: change data 


comm: 


case: 
uusend: 

send, sendto, sendmsg: 
kill: 

mail: 

ping: 

sendmail: 

binmail: 

socket. 

kill: 

killpg: 


aliases: aliases file for 


send, sendto, 

send, 

diction, explain: print wordy 

spp: Xerox 

trsp: transliterate 

slattach: attach 

comsat: biff 

fingerd: remote user information 

ftpd: DARPA Internet File Transfer Protocol 
named: Internet domain name 

rexecd: remote execution 

rlogind: remote login 

rshd: remote shell 

rwhod: system status 

talkd: remote user communication 

telnetd: DARPA TELNET protocol 

tftpd: DARPA Trivial File Transfer Protocol 
timed: time 
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run a command at low priority (sh only). 
run command immune to hangups. 
tun low priority process. 
run off bibliographic database. 
running processes. 
running processes. 
ruptime: show host status of local machines. 
ruserok: routines for returning a stream to a 
twho: who’s logged in on local machines. 
rwhod: system status server. 
rx: DEC RX02 floppy disk interface. 
RX02 floppy disk interface. 
rxformat: format floppy disks. 
sa, accton: system accounting. 
sail: multi-user wooden ships and iron men. 
save a core dump of the operating system. 
savecore: save a core dump of the operating system. 
sbrk: change data segment size. 
scalb: copysign, remainder, exponent manipulations. 
scan a directory. 
scandir, alphasort: scan a directory. 
scanf, fscanf, sscanf: formatted input conversion. 
scanning and processing language. 
sccs: front end for the SCCS subsystem. 
SCCS subsystem. 
schedule signal after specified time. 
schedule signal after specified time. 
scheduling priority. 
screen. 
screen functions with ‘‘optimal’’ cursor motion. 
screen oriented (visual) display editor based on 
script for auto-reboot and daemons. 
script: make typescript of terminal session. 
scripts. 
sdiv, itom: multiple precision integer arithmetic. 
search a file for a pattern. 
secret mail. 
sector information. 
sectors. 
sed: stream editor. 
seekdir, rewinddir, closedir: directory operations. 
segment size. 
select or reject lines common to two sorted files. 
select: synchronous I/O multiplexing. 
selector in switch. 
send a file to a remote host. 
send a message from a socket. 
send a signal to a process. 
send and receive mail. 
send ICMP ECHO_REQUEST packets to network hosts. 
send mail over the internet. 
send or receive mail among users. 
send, sendto, sendmsg: send a message from a 
send signal to a process. 
send signal to a process group. 
sendbug: mail a system bug report to 4bsd-bugs. 
sendmail. 
sendmail: send mail over the internet. 
sendmsg: send a message from a socket. 
sendto, sendmsg: send a message from a socket. 
sentences; thesaurus for diction. 
Sequenced Packet Protocol. 
sequenced packet protocol trace. 
serial lines as network interfaces. 
server. 
server. 
server. 
server. 
server. 
server. 
server. 
server. 
server. 
server. 
server. 
server daemon. 
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nice(1) 
esh(1) 
esh(1) 
roffbib(1) 
gcore(1) 
renice(8) 
ruptime(1C) 
remd(3) 
rwho(1C) 
rwhod(8C) 
rx(4) 

1x(4) 
rxformat(8V) 
sa(8) 

sail(6) 
savecore(8) 
savecore(8) 
brk(2) 
ieee(3M) 
scandir(3) 
scandir(3) 
scanf(3S) 
awk(1) 
secs(1) 
secs(1) 
alarm(3C) 
ualarm(3) 
getpriority(2) 
clear(1) 
curses(3X) 
vi(1) 

re(8) 
script(1) 
esh(1) 
mp(3X) 
grep(1) 
xsend(1) 
bad144(8) 
badsect(8) 
sed(1) 
directory(3) 
brk(2) 
comm(1) 
select(2) 
esh(1) 
uusend(1C) 
send(2) 
kill(3F) 
mail(1) 
ping(8) 
sendmail(8) 
binmail(1) 
send(2) 
kill(2) 
killpg(2) 
sendbug(1) 
aliases(5) 
sendmail(8) 
send(2) 
send(2) 
diction(1) 
spp(4P) 
trsp(8C) 
slattach(8C) 
comsat(8C) 
fingerd(8C) 
ftpd(8C) 
named(8) 
rexecd(8C) 
rlogind(8C) 
rshd(8C) 
rwhod(8C) 
talkd(8C) 
telnetd(8C) 
tftpd(8C) 
timed(8) 


April 1986 


- lxiv - 


logout: end 

script: make typescript of terminal 
ascii: map of ASCII character 
stty, gtty: 

sigstack: 


sigsetmask: 

umask: 

utime: 

utimes: 

setgroups: 

apply: apply a command to a 
getsockopt, setsockopt: get and 
hostid: 

hostname: 

setpgrp: 

nice: 

setregid: 

setreuid: 

eval, exec, exit, export, login, read, readonly, 
getty: 

stty: 

tabs: 

date: print and 

setuid, seteuid, setruid, setgid, setegid, setrgid: 
setenv: 

a stream. 

stream. setbuf, 

setuid, seteuid, setruid, setgid, 


user and group ID. setuid, 

entry. getfsent, getfsspec, getfsfile, getfstype, 
setuid, seteuid, setruid, 

getgrent, getgrgid, getgrnam, 


gethostbyname, gethostbyaddr, gethostent, 
host. gethostid, 

gethostname, 

getitimer, 


crypt, 

setbuf, setbuffer, 

syslog, openlog, closelog, 

getnetent, getnetbyaddr, getnetbyname, 


getpriority, 

getprotoent, getprotobynumber, getprotobyname, 
entry. getpwent, getpwuid, getpwnam, 

getpwent, getpwuid, getpwnam, setpwent, endpwent, 


setuid, seteuid, setruid, setgid, setegid, 
consumption. getrlimit, 

group ID. setuid, seteuid, 

getservent, getservbyport, getservbyname, 
getsockopt, 

for changing/ random, srandom, initstate, 
gettimeofday, 

getttyent, getttynam, 

set user and group ID. 

getusershell, 

continue, cd, eval, exec, exit, export, login,/ 
xstr: extract strings from C programs to implement 
exit: leave 

rsh: remote 

system: issue a 

csh: a 

eval: re-evaluate 

popd: pop 

pushd: push 

alias: 

suspend: suspend a 

rshd: remote 

set: change value of 
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services: service name data base. 

session. 

session. 

Set. 6 6 ew ew we we ww 

set and get terminal state (defunct). 

set and/or get signal stack context. 

set: change value of shell variable. 

set current signal mask. 

set file creation mode mask. 

set file times. 

set file times. 

set group access list. 

set of arguments. 

set options on sockets. * 
set or print identifier of current host Ssteehs 

set or print name of current host system. 

set process group. 

set program priority. 

set real and effective group ID. 

set real and effective user ID’s. 

set, shift, times, trap, umask, wait: conan’) ied, 
set terminal mode. 

set terminal options. 

set terminal tabs. 

set the date. 

set user and group ID. 

set variable in environment. 

setbuf, setbuffer, setlinebuf: assign butfenaz ie 
setbuffer, setlinebuf: assign buffering to a 
setegid, setrgid: set user and group ID. 

setenv: set variable in environment. 

seteuid, setruid, setgid, setegid, setrgid: set 
setfsent, endfsent: get file system descriptor file 
setgid, setegid, setrgid: set user and group ID. 
setgrent, endgrent: get group file entry. 
setgroups: set group access list. - 
sethostent, endhostent: get network host aunty 
sethostid: get/set unique identifier of current 
sethostname: get/set name of current host. 
setitimer: get/set value of interval timer. 
setjmp, longjmp: non-local goto. 

setkey, encrypt: DES encryption. 

setlinebuf: assign buffering to a stream. 
setlogmask: control system log. 

setnetent, endnetent: get network entry. 
setpgrp: set process group. 7 
setpriority: get/set program scheduling aon 
setprotoent, endprotoent: get protocol entry. 
setpwent, endpwent, setpwfile: get password file 
setpwfile: get password file entry. 

setquota: enable/disable quotas on a file system. 
setregid: set real and effective group ID. 
setreuid: set real and effective user ID’s. 
setrgid: set user and group ID. 

setrlimit: control maximum system resource 
setruid, setgid, setegid, setrgid: set user and 
setservent, endservent: get service entry. 
setsockopt: get and set options on sockets. 


setstate: better random number generator; routines 


settimeofday: get/set date and time. 

setttyent, endttyent: get ttys file entry. 

setuid, seteuid, setruid, setgid, setegid, setrgid: 
setusershell, endusershell: get legal user shells. 
sh, for, case, if, while, : , . , break, 

shared strings. 

shell. 

shell. 

shell command. . : 
shell (command interpreter with C jie: ern 
shell data. 3 

shell directory staole: 

shell directory stack. 

shell macros. a Sy ie 

shell, resuming its superior. 

shell server. 

shell variable. 
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services(5) 
esh(1) 
script(1) 
ascii(7) 
stty(3C) 
sigstack(2) 
esh(1) 
sigsetmask(2) 
umask(2) 
utime(3C) 
utimes(2) 
setgroups(2) 
apply(1) 
getsockopt(2) 
hostid(1) 
hostname(1) 
setpgrp(2) 
nice(3C) 
setregid(2) 
setreuid(2) 
sh(1) 

getty(8) 
stty(1) 

tabs(1) 
date(1) 
setuid(3) 
esh(1) 
setbuf(3S) 
setbuf(3S) 
setuid(3) 
esh(1) 
setuid(3) 
getfsent(3) 
setuid(3) 
getgrent(3) 
setgroups(2) 
gethostbyname(3N) 
gethostid(2) 
gethostname(2) 
getitimer(2) 
setjmp(3) 
crypt(3) 
setbuf(3S) 
syslog(3) 
getnetent(3N) 
setpgrp(2) 
getpriority(2) 
getprotoent(3N) 
getpwent(3) 
getpwent(3) 
setquota(2) 
setregid(2) 
setreuid(2) 
setuid(3) 
getrlimit(2) 
setuid(3) 
getservent(3N) 
getsockopt(2) 
random(3) 
gettimeofday(2) 
getttyent(3) 
setuid(3) 
getusershell(3) 
sh(1) 

xstr(1) 

esh(1) 
rsh(1C) 
system(3) 
esh(1) 

esh(1) 

esh(1) 

esh(1) 

esh(1) 

esh(1) 
rshd(8C) 
csh(1) 
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@: arithmetic on 
unset: discard 
exec: overlay 

setusershell, endusershell: get legal user 


/exec, exit, export, login, read, readonly, set, 
sail: multi-user wooden 
long, 

groups: 

ruptime: 

uptime: 

lastcomm: 

netstat: 

uusnap: 

construct a file. what: 
shutdown: 


connection. 


calls. 
login: 


pause: stop until si 
signal: change the action fora si 


sigreturn: return from 
alarm: schedule 
ualarm: schedule 


signal: simplified software 
sigvec: software 
sigsetmask: set current 
psignal, sys_siglist: system 


sigstack: set and/or get 

kill: send 

kill: send a 

killpg: send 

sigblock: block 

sigpause: atomically release blocked 
(temporary). infnan: 

siginterrupt: allow 

wait for interrupt. 


signal: 
tc: photoypesetter 
trigonometric functions and their inverses. 


null: data 

uupoll: poll a remote UUCP 

brk, sbrk: change data segment 
getdtablesize: get descriptor table 
getpagesize: get system page 
pagesize: print system page 

size: 


diskpart: calculate default disk partition 
interfaces. 


spline: interpolate 


uusnap: show 

snake, 

accept: accept a connection on a 

bind: bind a name to a 

connect: initiate a connection on a 

listen: listen for connections on a 

recv, recvfrom, recvmsg: receive a message from a 
send, sendto, sendmsg: send a message from a 


imp: IMP raw 
getsockname: get 


4.3BSD 


shell variables. 
shell variables. 
shell with specified command. 
shells. getusershell, 
shift: manipulate argument list. 
shift, times, trap, umask, wait: command language. 
ships and iron men. 
short: integer object conversion. 
show group memberships. 
show host status of local machines. 
show how long system has been up. 
show last commands executed in reverse order. 
show network status. 
show snapshot of the UUCP system. 
show what versions of object modules were used to 
shut down part of a full-duplex connection. 
shutdown: close down the system at a given time. 
shutdown: shut down part of a full-duplex 
sigblock: block signals. 
siginterrupt: allow signals to interrupt system 


signal after specified time. 
signal after specified time. 
signal: change the action for a signal. 
signal facilities. 
signal facilities. 
signal mask. 
signal messages. 
signal: simplified software signal facilities. 
signal stack context. 
signal to a process. 
signal to a process. 
signal to a process group. 
signals. 
signals and wait for interrupt. 
signals invalid floating-point operations on a VAX 
signals to interrupt system calls. 
sigpause: atomically release blocked signals and 
sigreturn: return from signal. 
sigsetmask: set current signal mask. 
sigstack: set and/or get signal stack context. 
sigvec: software signal facilities. 
simplified software signal facilities. 
simulator. 
sin, cos, tan, asin, acos, atan, atan2: 
sinh, cosh, tanh: hyperbolic functions. 
sink. 
site. 
size. 
size. 
size. 
size. 
size of an object file. 
size: size of an object file. 
sizes. 
slattach: attach serial lines as network 
sleep: suspend execution for an interval. 
sleep: suspend execution for an interval. 
sleep: suspend execution for interval. 
smooth curve. 
snake, snscore: display chase game. 
snapshot of the UUCP system. 
snscore: display chase game. 
socket. 
socket. 
socket. 
socket. 
socket. 
socket. 
socket: create an endpoint for communication. 
socket interface. 
socket name. 


-lxv - 


esh(1) 


sail(6) 
long(3F) 
groups(1) 
ruptime(1C) 
uptime(1) 
lastcomm(1) 
netstat(1) 
uusnap(8C) 
what(1) 
shutdown(2) 
shutdown(8) 
shutdown(2) 
sigblock(2) 
siginterrupt(3) 
login(1) 
pause(3C) 
signal(3F) 
sigreturn(2) 
alarm(3C) 
ualarm(3) 
signal(3F) 
signal(3C) 
sigvec(2) 
sigsetmask(2) 
psignal(3) 
signal(3C) 
sigstack(2) 
kill(2) 
killF) 
killpg(2) 
sigblock(2) 
sigpause(2) 
infnan(3M) 
siginterrupt(3) 
sigpause(2) 
sigreturn(2) 
sigsetmask(2) 
sigstack(2) 
sigvec(2) 
signal(3C) 
te(1) 

sin(3M) 
sinh(3M) 
null(4) 
uupoll(8C) 
brk(2) 
getdtablesize(2) 
getpagesize(2) 
pagesize(1) 
size(1) 
size(1) 
diskpart(8) 
slattach(8C) 
sleep(1) 
sleep(3F) 
sleep(3) 
spline(1G) 
snake(6) 
uusnap(8C) 
snake(6) 
accept(2) 
bind(2) 
connect(2) 
listen(2) 
recv(2) 
send(2) 
socket(2) 
imp(4P) 
getsockname(2) 
socketpair(2) 
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getsockopt, setsockopt: get and set options on 
socketpair: create a pair of connected 


lo: 

in ip packets.. nsip: 
signal: simplified 
sigvec: 

canfield, cfscores: the 
qsort: quicker 


qsort: quick 


tsort: topological 
sortbib: 
sort: 


comm: select or reject lines common to two 

look: find lines in a 

soelim: eliminate 

soelim: eliminate . 

indent: indent and format C program 

mkstr: create an error message file by massaging C 
whereis: locate 


line, circle, arc, move, cont, point, linemod, 
expand, unexpand: expand tabs to 

way. vfork: 

exec: overlay shell with 

truncate: truncate a file toa 

alarm: schedule signal after 

alarm: execute a subroutine after a 

ualarm: schedule signal after 

swapon: 


spell, 
spell, spellin, spellout: find 
spell, spellin, 


split: 
files. fsplit: 
frexp, Idexp, modf: 


uuclean: uucp 

Ipq: 

atrm: remove jobs 

Iprm: remove jobs from the line printer 


printf, fprintf, 

cbrt, 

cbrt, sqrt: cube root, 

rand, 

generator; routines for changing/ random, 
scanf, fscanf, 


popd: pop shell directory 
pushd: push shell directory 
sigstack: set and/or get signal 
drtest: 

bad144: read/write dec 

stdio: 

htable: convert NIC 

ddn: DDN 


stty, gtty: set and get terminal 
fsync: synchronize a file’s in-core 
if: conditional 

fstab: 

hashstat: print command hashing 
iostat: report I/O 

vmstat: report virtual memory 
systat: display system 

exit: terminate process with 
netstat: show network 

ps: process 

stat, Istat, fstat: get file 

stat, Istat, fstat: get file 
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SOCKEIS; ose Scere ee i atl hee ee a a getsockopt(2) 
SOGKEIS? ,. feo og ity hs Tee Jes By as WES dae Boe aah ee tae ok SS socketpair(2) 
soelim: eliminate .so’s from nroffinput. . ......... soelim(1) 
software loopback network interface. . .......2.0. lo(4) 
software network interface encapsulating ns packets ..... nsip(4) 
software signal facilities. . .. 2... 2 ee ee ee ee signal(3C) 
software signal facilities. . .. 6... 2... eee eee sigvec(2) 
solitaire card game canfield. . ........-2. ee ee canfield(6) 
SOLS. 2.5 - Makasar So eee ah Vee wie Se eh Loe te: oe, Se De qsort(3) 
SOMES Sse dee Seis oe oo Sete eee ME Sos See lae O0 we ot hd qsort(3F) 
BOE aa a. ea a as da Se aa EE ae Se tsort(1) 
sort bibliographic database. . . . 1... 2.2 ee ee eee sortbib(1) 
sortormerge fil€s.: 6 sue wee A iiss Bre EE oe Se ae sort(1) 
sort: sortor merge files. .......-..-6.2-+208- sort(1) 
sortbib: sort bibliographic database. . ........4.- sortbib(1) 
SOrted ALES. sie tae Cg: es ROSE Sey cet Se ee Ae eee comm(1) 
SOrtEM Vist: ee cok ud, “sess OM Sed cheat oe Re ce cg Cae ee oR, Sa look(1) 
so’sfromnroffinput. .. 1... 1... 6 ee ee ee ee soelim(1) 
so’sfromnroffinput. . 2... 2... eee ee ee eee soelim(1) 
SOUICES isrey Fy coc tase yst Poa fer Sees te tate Wes 79 e cat cg Mar hse Hey Toy cat es indent(1) 
SOUICE? = 26% sda od ek Yee Go? HN tae HPS Veet Er sdedan tise ag Goblet cae ee tae Us mkstr(1) 
source, binary, and or manual for program. ........ whereis(1) 
source: read commands from file. ..........6.. csh(1) 
space, closepl: graphics interface. /erase, label, . . .. 2... plot(3X) 
spaces, and vice versa, ww we ew ee ee ee eee expand(1) 
spawn new process in a virtual memory efficient ...... vfork(2) 
specifiedcommand. .........-550-5-50-e-5 208s esh(1) 
specified length. sas. ea, ee ee, Be ee we truncate(2) 
Specified mes a. ch. ee Gee aes Sta See ete he ge a alarm(3C) 
Specified times. eee seo esslse at See ta oan lee Ge gt” Veen Tee Se Os alarm(3F) 
Speciiedstimes, <a. 025s wet oi a er eee Ge be We Oe ualarm(3) 
specify additional device for paging andswapping. ..... swapon(8) 
spell, spellin, spellout: find spelling errors. . ........ spell(1) 
spellin, spellout: find spelling errors. ........... spell(1) 
Spelling errors’... wo 6° i: Ss ee cee ie ey ea spell(1) 
spellout: find spelling errors. ........4.6-24-+06-. spell(1) 
spline: interpolatesmoothcurve. .........068. spline(1G) 
splitafileinto pieces. . . 1... 27. ee ee ee eee split(1) 
split a multi-routine Fortran file into individual ....... fsplit(1) 
split into mantissa and exponent. .........0.8. frexp(3) 
split: splita fileinto pieces. . . 2... 1... ee ee eee split(1) 
spool directory clean-up. . .. 1... 5. eee ee eee uuclean(8C) 
spool queue examination program. .........+.2-. Ipq(1) 
spooled: by ate: «a. ae Gl we A Se ara Ee ee atrm(1) 
Spooling quevie ie. ses See cee eee ee Se ees Iprm(1) 
spp: Xerox Sequenced Packet Protocol. .......... spp(4P) 
sprintf: formatted output conversion. . .... 2... ee. printf(3S) 
sqrt: cube root, square root. . 2... 6. ee ee ee eee sqrt(3M) 
SQUATETOOL. oeacece Sands oF. cect ey ced SE ee cae tg sqrt(3M) 
srand: random number generator. ........+.+.2--. rand(3C) 
srandom, initstate, setstate: betterrandom number ...... random(3) 
sscanf: formatted input conversion. ........e+8. scanf(3S) 
stab: symbol table types. 2... 1 1 2 ee ee eee ee stab(5) 
Stack.” ee Ss ed eae at oe SES, & Sih SE See) oe esh(1) 
Stacks: Sash nacre cP ha Wee Sa SE, hat oT Se Ss CDG eRe Ge Se esh(1) 
StaCkicOntext pee ke-sintee Veh SEO Ne hverlat Sahel He ade ecttee ae GE sigstack(2) 
standalone disk test program. . .......-5.-2-+ 206s drtest(8) 
standard 144 bad sector information. ........... bad144(8) 
standard buffered input/output package. . ..... 2.2.4. stdio(3S) 
standard format host tables. . 2... 6. 2 ee ee ee ee htable(8) 
Standard Mode X.25IMPinterface. ........... ddn(4) 
stat, Istat, fstat: get filestatus. 2... 1... 2... eee stat(2) 
stat, Istat, fstat: get filestatus. 2... 1... 2... 2.2. eee stat(3F) 
state: (Gefunct).. 4.42) eis ee ee Ah ei es ee Bie aay eae stty(3C) 
state with thatondisk. . 2... 1. 6 6 ee eee ew ee fsync(2) 
statements ce: kone cde ee Geese ye oe ee hy Eee da RSS A He ee esh(1) 
static information about the filesystems. . ......... fstab(5) 
StatistiGss °.c-s6 oS, Tk As ae et an ra eb dak esh(1) 
SUALISHICS © 102." 50-25: ASL de Seah Se ay Ge ets a ae hee iostat(1) 
SUALISLICSS», si ue. ne Me Sey ie ae A oR UR Mee a DS ERE es eS vmstat(1) 
Statistics: OMA Cities eos a. dos ee we a Se os a Fe systat(1) 
SUALUSS. ~ (ernie see ce ec errs age cause a> dae Spite an ewe cee GS exit(3F) 
BIQUUS) ia. ea HE a OR He a Oe, ee netstat(1) 
SUALUStce {35s selec o dee ge ee NR eT ces ey eee Me Je TR eh wes ps(1) 
SEALS, pi vide, Fee Soh tencec' “sir le> teh Sal te Gee ereter Sedan ae er iae dee? Be stat(2) 
SUALUSS, 5 noe chlo! Gee Whnee Aches Soe AS net OTe Ae Ses ae aS stat(3F) 
4.3BSD 


Permuted Index 


ferror, feof, clearerr, fileno: stream 
sysline: display system status on 
ruptime: show host 

sysline: display system 

rwhod: system 


directories. 


halt: 

pause: 

icheck: file system 

up: unibus 

subroutines. dbminit, fetch, 

strlen, index, rindex: string operations. 

rindex: string operations. strcat, strncat, 
operations. streat, strncat, stremp, strncmp, 
fclose, fflush: close or flush a 

fopen, freopen, fdopen: open a 

fseek, ftell, rewind: reposition a 

getchar, fgetc, getw: get character or word from 
gets, fgets: get a string from a 

putchar, fputc, putw: put character or word on a 
puts, fputs: put a string on a 

setbuffer, setlinebuf: assign buffering to a 
ungetc: push character back into input 

sed: 

ferror, feof, clearerr, fileno: 

remd, rresvport, ruserok: routines for returning a 
rexec: return 

fdate: return date and time in an ASCII 

gets, fgets: get a 

puts, fputs: put a 

bcopy, bemp, bzero, ffs: bit and byte 

strncmp, strepy, strncpy, strlen, index, rindex: 
extract strings from C programs to implement shared 
other binary, file. 

strings. xstr: extract 

strings: find the printable 

basename: 


strceat, strncat, strcmp, strncmp, strcpy, strncpy, 
index, rindex: string operations. strcat, 

string operations. strcat, strncat, strcmp, 
strcat, strncat, strcmp, strncmp, strcpy, 


struct: 


document. 


alarm: execute a 

fetch, store, delete, firstkey, nextkey: data base 
dbm_nextkey, dbm_error, dbm_clearerr: data base 
1ib2648: 

su: 

sccs: front end for the SCCS 

sum: 


du: 

quot: 

repquota: 

sync: update the 

update: periodically update the 

sync: update 

suspend: suspend a shell, resuming its 
inetd: internet 

intro: introduction to special files and hardware 
style: analyze 

suspend: 

sleep: 

sleep: 

sleep: 

usleep: 


interface. ps: Evans and 
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status inquiries. 

status line of a terminal, 

status of local machines. 7 

status on status line of a terminal. 

status server. 

stdio: standard buffered input/output package. 
sticky: persistent text and append-only 

stop: halt a job or process. mars 

stop the processor. 

stop until signal. 

storage consistency check. 

storage module controller/drives. 

store, delete, firstkey, nextkey: data base 
strcat, strncat, strcmp, strncmp, strcpy, strncpy, 
strcmp, strncmp, strcpy, strncpy, strlen, index, 
strepy, strncpy, strlen, index, rindex: string 
stream. 

stream. 

stream. .. 

stream. getc, 

stream. .. 

stream. putc, 

Stream. .... 

stream. setbuf, 

stream. 

stream editor, 

stream status inquiries. 

stream to a remote command. 

stream to a remote command. 

string. 

string from a stant 

string on a stream. 

string operations. 

string operations. strcat, stacar esticin, 
strings. xstr: : 
strings: find the printable: ciaes: ina noble, 6 or 
strings from C programs to implement shared 
strings in a object, or other binary, file. 

strip filename affixes. 

strip: remove symbols and relocation bik 
strlen, index, rindex: string operations. & 
strncat, strcmp, strncmp, strcpy, strncpy, strlen, 
strncmp, strcpy, strncpy, strlen, index, rindex: 
strncpy, strlen, index, rindex: string operations. 
struct: structure Fortran programs. 

structure Fortran programs. . 

stty, gtty: set and get terminal state (defunct. 
stty: set terminal options. 

style: analyze surface etiatasletigtics ofa a 

su: substitute user id temporarily. 

subroutine after a specified time. 

subroutines. dbminit, 

subroutines. /dbm_ store, aban _ delete, aban _firstkey, 
subroutines for the HP 2648 graphics terminal. 
substitute user id ike ¢ Ss 
subsystem. ; 

sum and count blocks i ina file. 

sum: sum and count blocks in a file. 
summarize disk usage. : 

summarize file system ownership. 

summarize quotas for a file system. 

super block. 

super block. 

super-block. 

superior. 

“*super—server’’. 

support. : 

surface chiuracienates er a doninient 

suspend a shell, resuming its superior. 

suspend execution for an interval. 

suspend execution for an interval. 

suspend execution for interval. 

suspend execution for interval. s 
suspend: suspend a shell, resuming its superior. 
Sutherland Picture System 2 graphics device 
swab: swap bytes. Bc ioS Rs 
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ferror(3S) 
sysline(1) 
ruptime(1C) 
sysline(1) 
rwhod(8C) 
stdio(3S) 
sticky(8) 
esh(1) 
halt(8) 
pause(3C) 
icheck(8) 
up(4) 
dbm(3X) 
string(3) 
string(3) 
string(3) 
fclose(3S) 
fopen(3S) 
fseek(3S) 
getc(3S) 
gets(3S) 
putc(3S) 
puts(3S) 
setbuf(3S) 
ungetc(3S) 
sed(1) 
ferror(3S) 
remd(3) 
rexec(3) 
fdate(3F) 
gets(3S) 
puts(3S) 
bstring(3) 
string(3) 
xstr(1) 
strings(1) 
xstr(1) 
strings(1) 
basename(1) 
strip(1) 
string(3) 
string(3) 
string(3) 
string(3) 
struct(1) 
struct(1) 
stty(3C) 
stty(1) 
style(1) 
su(1) 
alarm(3F) 
dbm(3X) 
ndbm(3) 
1ib2648(3X) 
su(1) 
secs(1) 
sum(1) 
sum(1) 
du(1) 
quot(8) 
repquota(8) 
sync(8) 
update(8) 
sync(2) 
csh(1) 
inetd(8) 
intro(4) 
style(1) 
esh(1) 
sleep(1) 
sleep(3F) 
sleep(3) 
usleep(3) 
esh(1) 
ps(4) 
swab(3) 
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swab: 

swapon: add a 

paging/swapping. 

swapping. 

swapon: specify additional device for paging and 
breaksw: exit from 

case: selector in 

default: catchall clause in 

endsw: terminate 


dbx: dbx 

stab: 

readlink: read value of a 
symlink: make 

strip: remove 


adjtime: correct the time to allow 

disk. fsync: 

select: 

csh: a shell (command interpreter) with C-like 
L. 


perror, 
terminal. 
system log. 


perror, sys _errlist, 
psignal, 


hy: Network 

syslogd: log 

kgmon: generate a dump of the operating 
ns: Xerox Network 

rehash: recompute command hash 
unhash: discard command hash 

mkhosts: generate hashed host 
mkpasswd: generate hashed password 
mtab: mounted file system 

vwidth: make troff width 

dbx: dbx symbol 

getdtablesize: get descriptor 

stab: symbol 

htable: convert NIC standard format host 
route: manually manipulate the routing 
tbl: format 

gettable: get NIC format host 

tabs: set terminal 


expand, unexpand: expand 
ctags: create a 


talk: 


functions and their inverses. sin, cos, 

sinh, cosh, 

tcopy: copy a mag 

tp: manipulate 

tar: 

tar: 

ut: UNIBUS TU45 tri-density 

tp: DEC/mag 

tclose, tread, twrite, trewin, tskipf, tstate: {77 
mt: magnetic 


deroff: remove nroff, troff, 


tape I/O. topen, 
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Swap bytess.,.. cos cé reeves ee cag, Neo 1d we. aS Se Se ae aes swab(3) 
swap device for interleaved paging/swapping. ....... swapon(2) 
swapon: add a swap device forinterleaved ......... swapon(2) 
swapon: specify additional device for pagingand ...... swapon(8) 
SWAPPING 7s) cae Se at ee es ss UE Sa ae > LN Me we PL swapon(8) 
SWAtChs 35 m6 tape) ei rhet ts <a. tee eb eee ete Mel abe lets wes ee a csh(1) 
Switch. 2x6. hale dx eee Gale Me cela 4d csh(1) 
SWAtCHS “yc Be A. 2a ES a hy tee sea Ute aay Meo. ARS eh te eo eS esh(1) 
SWICK: wise. 15,5, slo. US age AS PL Se, RSs 1S aD ees, Be Bs esh(1) 
switch: multi-way command branch. . .......-.- csh(1) 
symbol table information. ...........2-+.2-. dbx(5) 
symbol table types. 2... 6 1 2 ee ee ee ee ee stab(5) 
Symbolic link): ‘s- s36 Ase 6 oes Ries Bre Ee oe See readlink(2) 
symbolic linktoafile. ..........26.6-22-0200. symlink(2) 
symbols and relocation bits. ........4.+-+-+.e--. strip(1) 
symlink: make symbolic linktoafile .......... symlink(2) 
symorder: rearrangenamelist. . .....-..-e ee ee symorder(1) 
sync: update super-block. ........-4.+0208- sync(2) 
sync: update the super block. . ........-42+2- sync(8) 
synchronization of the system clock. ........2.+.- adjtime(2) 
synchronize a file’s in-core state withthaton ........ fsync(2) 
synchronous I/O multiplexing. . .. 2... 2... ee ee select(2) 
SyMtAR fe nk 6k 0S oe ok a ed ae, day OES ve Se aha Gt AS Ne Se csh(1) 
sys: UUCP remote host description file. .........2.. L.sys(5) 
syscall: indirect systemcall. . 2... 2... 2 ee eee syscall(2) 
sys_errlist, sys nerr: system errormessages. ........ perror(3) 
sysline: display system status on status lineofa ....... sysline(1) 
syslog, openlog, closelog, setlogmask: control ....... syslog(3) 
syslogd: log systems messages. . ~~... 2. + ee ee ee syslogd(8) 
syS_nerr: system errormessages. . . 2... ee ee eee perror(3) 
sys_siglist: system signal messages. . . 2... 2.2. eee psignal(3) 
systat: display system statisticsonacrt. .........-. systat(1) 
Systems Hyperchannelinterface. ..... 2.2.2.2 hy(4) 
systems messages. . 2. 6. ee ee ee ee ee eee syslogd(8) 
system’s profile buffers. . .........6-62-+2008 kgmon(8) 
Systems(tm) protocol family. . ........6..2286- ns(4F) 
tables © cae Teese peak thy eta iat bette Go Bee, oes aes Lad at uy el woe tet Le esh(1) 
table: . edt elated Me Se eed hate ae me. atts csh(1) 
tables: * “ele eh ch cele by ety nce cae Bh ceed WT da hn mkhosts(8) 
tables . gafts tee te eit Std ee AD ete Gout 3S mkpasswd(8) 
tables «e.% Spveys Bispace le Boe TS SP eB iee S oa, oe ae mtab(5) 
table‘for.afont. . 96.0.6 0006 see see ee Re vwidth(1) 
table:informations © <.2\02°$...0. 8) bei ene, eo RN ae SK dbx(5) 
table: Sizes es et Ae oiee Fe SE Sead. Se ee is Sa REELS Ge AG Oe getdtablesize(2) 
tableitypese- Ar carle ss Sod So oes ee ale Sess eS as stab(5) 
TADIESS « de: 4b cet Ses Series once dae Sat gees Se Ua wide Soh wen es Soe eaeRel We htable(8) 
VAWIEG.- gg" dg ie co $2 SESE v3 eR eS EE route(8C) 
tables for nroff ortroff. . 2... 1... ee ee ee ee tbl(1) 
fables froma hosts yt: ce “Ae ow ES. ee Be SR gettable(8C) 
HAD So ea ig: way ia AE oth Te Seat Lact et ok Te eta UEN Gh “ee UeSee Le tabs(1) 
tabs: setterminaltabs. . . 1... 6 2 ee ee ew wens tabs(1) 
tabs to spaces, and vice versa. . 2. 2. 2 ee ee ee ee ee expand(1) 
tagstile..» 23 “ss ek cea a teats UE ae ee a ae EE ae Se 1 ctags(1) 
tail: deliver the last partofafile. ............. tail(1) 
talk: talk to another user. . 2... 6 1 ee ee ew ee ee talk(1) 
talk‘to another tser:: 2:46. Wosbee ee SR alee NS talk(1) 
talkd: remote user communication server. .......6-. talkd(8C) 
tan, asin, acos, atan, atan2: trigonometric ......... sin(3M) 
tanh: hyperbolic functions. .........-6.-0080- sinh(3M) 
LAP Es? AOS Gos 8 Sates seater eats LA Aas Reach raenkS -S opehae? Sade a. Laces os tcopy(1) 
TAPE ALCHIVEs ©. 8 ee Se Ree ne eae EO ee aes tp(1) 
tape archive fileformat. . .......-6-5. 52.22 ee tar(5) 
tape:archivers 69 sew Sl ees BS eee ee ee tar(1) 
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tape manipulating program. .........4.-ee06- mt(1) 
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tare tape-archiver:.—§ 20.40 ese a Se iL ee we tar(1) 
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tbl andeqn constructs. . 2... 1. ee ew ee ee ee deroff(1) 
tbl: format tables for nroff ortroff. . 2... ......08- tbl(1) 
tc: photoypesetter simulator. ..........-+.2-8. tce(1) 
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tcopy:copyamagtape. .... 1... 2 ee ee eee tcopy(1) 
tcp: Internet Transmission Control Protocol ........ tep(4P) 
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tk: paginator for the 

last: indicate last logins of users and 
index, rindex, InbInk, len: 
operations. opendir, readdir, 

telnet: user interface to the 

telnetd: DARPA 


su: substitute user id 
signals invalid floating-point operations on a VAX 


1ib2648: subroutines for the HP 2648 graphics 
lock: reserve a 
sysline: display system status on status line of a 
ttyname, isatty, ttyslot: find name of a 
vhangup: virtually ‘‘hangup’’ the current control 
worms: animate worms on a display 

termcap: 

gettytab: 

tset: 

pty: pseudo 

tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: 
ttys: 

tty: general 

getty: set 

dmf: DMF-32, 

dmz: DMZ-32 

tty: get 

stty: set 

ttynam, isatty: find name of a 

clear: clear 
script: make typescript of 

stty, gtty: set and get 

tabs: set 

term: conventional names for 

wait, wait3: wait for process to 

wait: wait for a process to 

_ exit: 

output. exit: 

kill: 

endif: 

end: 

exit: 

endsw: 

abort: abnormal 


drtest: standalone disk 

quiz: 

sticky: persistent 

ed: 

ex, edit: 

jove: an interactive display-oriented 
fmt: simple 

nroff: 

troff, nroff: 

ms: 


terminal independent operation routines. 
independent operation routines. tgetent, tgetnum, 
independent operation routines. tgetent, 
operation routines. tgetent, tgetnum, tgetflag, 
routines. tgetent, tgetnum, tgetflag, tgetstr, 
acos, atan, atan2: trigonometric functions and 
diction, explain: print wordy sentences; 
alarm: schedule signal after specified 

alarm: execute a subroutine after a specified 
at: execute commands at a later 

etime, dtime: return elapsed execution 
gettimeofday, settimeofday: get/set date and 
shutdown: close down the system at a given 
time, ftime: get date and 

time, ctime, ltime, gmtime: return system 
ualarm: schedule signal after specified 
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tee: pipe fitting. 

Tektronix 4014. 

teletypes. : 

tell about character objects, 

telldir, seekdir, rewinddir, closedir: directory: 
TELNET protocol. 

TELNET protocol server. 5 

telnet: user interface to the TELNET protec: 
telnetd: DARPA TELNET PEO server. 
temporarily. : ; 
(temporary). infnan: 

term: conventional names for terminals. 
termcap: terminal capability data base. 
terminal. 

terminal. 

terminal. 

terminal. 

terminal. 

terminal. ao 

terminal capability data base: 

terminal configuration data base. 

terminal dependent initialization. 

terminal driver. 7 
terminal independent operation PORTS: 
terminal initialization data. 

terminal interface. 

terminal mode. 

terminal multiplexor. 

terminal multiplexor. 

terminal name. 

terminal options. 

terminal port. 

terminal screen. 

terminal session. 

terminal state (defunct). 

terminal tabs. 

terminals. 

terminate. 

terminate. F 

terminate a process. . 

terminate a process after fiuchingoe any Spending 
terminate a process with extreme prejudice. 
terminate conditional. 

terminate loop. 

terminate process with status. 

terminate switch. 

termination. 

test: condition command. 

test program. 

test your knowledge. 

text and append-only directories: 

text editor. 

text editor. 

text editor. 

text formatter. 

text formatting. 

text formatting and fypeseinig.- 

text formatting macros. 

tftp: trivial file transfer proce. 

tftpd: DARPA Trivial File Transfer Protoss! server. 
tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: 
tgetflag, tgetstr, tgoto, tputs: terminal 7 
tgetnum, tgetflag, tgetstr, tgoto, tputs: onal, 
tgetstr, tgoto, tputs: terminal independent 
tgoto, tputs: terminal independent operation 
their inverses. sin, cos, tan, asin, 

thesaurus for diction. 

time. 

time. 

time. 

time. 

time. 

time. 

time. 

time. 

time. 
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tee(1) 

tk(1) 

last(1) 
index(3F) 
directory(3) 
telnet(1C) 
telnetd(8C) 
telnet(1C) 
telnetd(8C) 
su(1) 
infnan(3M) 
term(7) 
termcap(5) 
1ib2648(3X) 
lock(1) 
sysline(1) 
ttyname(3) 
vhangup(2) 
worms(6) 
termcap(5) 
gettytab(5) 
tset(1) 
pty(4) 
termcap(3X) 
ttys(5) 

tty(4) 
getty(8) 
dmf(4) 
dmz(4) 
tty(1) 

stty(1) 
ttynam(3F) 
clear(1) 
script(1) 
stty(3C) 
tabs(1) 
term(7) 
wait(2) 
wait(3F) 
exit(2) 
exit(3) 
kill(1) 
esh(1) 
csh(1) 
exit(3F) 
esh(1) 
abort(3F) 
test(1) 
drtest(8) 
quiz(6) 
sticky(8) 
ed(1) 

ex(1) 
jove(1) 
fmt(1) 
nroff(1) 
troff(1) 
ms(7) 
tftp(1C) 
tftpd(8C) 
termcap(3X) 
termcap(3X) 
termcap(3X) 
termcap(3X) 
termcap(3X) 
sin(3M) 
diction(1) 
alarm(3C) 
alarm(3F) 
at(1) 
etime(3F) 
gettimeofday(2) 
shutdown(8) 
time(3C) 
time(3F) 
ualarm(3) 
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time: 
time: 


fdate: return date and 
idate, itime: return date or 
profil: execution 

timed: 


adjtime: correct the 
gmtime, asctime, timezone: convert date and 
timedce: 


getitimer, setitimer: get/set value of interval 
times: get process 

utime: set file 

utimes: set file 


exit, export, login, read, readonly, set, shift, 
ctime, localtime, gmtime, asctime, 


ht: 
tm: 
mt: 


tmscp: DEC 


isgraph, iscntrl, isascii, toupper, tolower, 
popen, pclose: initiate I/O 

/isprint, isgraph, iscntrl, isascii, toupper, 
tstate: £77 tape I/O. 

tsort: 


/ispunct, isprint, isgraph, iscntrl, isascii, 


tgetent, tgetnum, tgetflag, tgetstr, tgoto, 


ptrace: process 

trpt: transliterate protocol 

trsp: transliterate sequenced packet protocol 
goto: command 

uucico, uucpd: 

ftp: ARPANET file 

tftp: trivial file 

ftpd: DARPA Internet File 

tftpd: DARPA Trivial File 

tr: 

ad: Data 

pi: Pascal interpreter code 

trpt: 

trsp: 

tcp: Internet 

uuencode, uudecode: encode/decode a binary file for 
trpfpe, fpecnt: 

trapov: 

traper: 

export, login, read, readonly, set, shift, times, 


I/O. topen, tclose, 


trek: 

topen, tclose, tread, twrite, 

ut: UNIBUS TU45 

sin, cos, tan, asin, acos, atan, atan2: 

tftp: 

tftpd: DARPA 

tbl: format tables for nroff or 

Lisp programs to be printed with nroff, vtroff, or 


deroff: remove nroff, 


April 1986 


time a command. 

time command. ; 
time, ctime, ltime, gmtime: return eee line, 
time, ftime: get date and time. 

time in an ASCII string. 

time in numerical form. 

time profile. 

time server daemon. 

time: time a command. 

time: time command. a8 

time to allow synchronization of the sgatens sige: 
time to ASCII. ctime, localtime, 

timed control program. 

timed: time server daemon. 

timedc: timed control program. 

timer. 

times. 

times. 

times. 

times: ie piosess dines : : 
times, trap, umask, wait: bommiand: fanzaaee: jexee) 
timezone: convert date and time to ASCII. 

tip, cu: connect to a remote system. 

tk: paginator for the Tektronix 4014. 

tm: TM-11/TE-10 magtape interface. 


TM-03/TE-16,TU-45,TU-77 MASSBUS magtape interface. . 


TM-11/TE-10 magtape interface. . 
TM78/TU-78 MASSBUS magtape interice, 
tmscp: DEC TMSCP magtape interface. 
TMSCP magtape interface. y 

tn3270: full-screen remote login to IBM VMICMS. 
toascii: character classification macros. es 
to/from a process. . 
tolower, toascii: character classification macros. 
topen, tclose, tread, twrite, trewin, tskipf, 
topological sort. 

touch: update date last modified of a file. 
toupper, tolower, toascii: character classification/ 
tp: DEC/mag tape formats. 

tp: manipulate tape archive. 

tputs: terminal independent operation Pouanes: 
tr: translate characters. 

trace. 

trace. 

trace. 

transfer. . 

transfer files queued yin uucp or uux. 

transfer program. 

transfer program. 

Transfer Protocol server. 

Transfer Protocol server. 

translate characters. 

Translation A/D converter. 

translator. 

transliterate protocol trace: < 
transliterate sequenced packet piotocel trace. 
Transmission Control Protocol. 

transmission via mail. 

trap and repair floating point fanlts. 

trap and repair floating point overflow. 

trap arithmetic errors. 

trap, umask, wait: command ers exe: eit 
traper: trap arithmetic errors. . 7 
trapov: trap and repair floating point ienion 
tread, twrite, trewin, tskipf, tstate: {77 tape 
trek: trekkie game. os ae 

trekkie game. 

trewin, tskipf, tstate: f7 7 tape VO. 

tri-density tape drive interface. : 
trigonometric functions and their inverses. 
trivial file transfer program. 

Trivial File Transfer Protocol server. 

troff. o bay tor yey gens 

troff. vlp: Format 

troff, nroff: text formatting and fypesctting. 
troff, tbl and eqn constructs. 
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time(1) 
csh(1) 
time(3F) 
time(3C) 
fdate(3F) 
idate(3F) 
profil(2) 
timed(8) 
time(1) 
csh(1) 
adjtime(2) 
ctime(3) 
timedc(8) 
timed(8) 
timedc(8) 
getitimer(2) 
times(3C) 
utime(3C) 
utimes(2) 
times(3C) 
sh(1) 
ctime(3) 
tip(1C) 
tk(1) 
tm(4) 
ht(4) 
tm(4) 
mt(4) 
tmscp(4) 
tmscp(4) 
tn3270(1) 
ctype(3) 
popen(3) 
ctype(3) 
topen(3F) 
tsort(1) 
touch(1) 
ctype(3) 
tp(5) 

tp) 
termcap(3X) 
tr(1) 
ptrace(2) 
trpt(8C) 
trsp(8C) 
csh(1) 
uucico(8C) 
ftp(1C) 
tftp(1C) 
ftpd(8C) 
tftpd(8C) 
tr(1) 

ad(4) 
pi(1) 
trpt(8C) 
trsp(8C) 
tcp(4P) 
uuencode(1C) 
trpfpe(3F) 
trapov(3F) 
traper(3F) 
sh(1) 
traper(3F) 
trapov(3F) 
topen(3F) 
trek(6) 
trek(6) 
topen(3F) 
ut(4) 
sin(3M) 
tftp(1C) 
tftpd(8C) 
tbl(1) 
vip(1) 
troff(1) 
deroff(1) 
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vwidth: make 
battlestar: a 
faults. 


trace. 


false, 
truncate: 


false, true: provide 
true, false: provide 


ts: 
topen, tclose, tread, twrite, trewin, 


topen, tclose, tread, twrite, trewin, tskipf, 


getttyent, getttynam, setttyent, endttyent: get 


ttyname, isatty, 

interface. 

ut: UNIBUS 

ht: TM-03/TE-16, 

tu: VAX-11/730 and VAX-11/750 
uu: 

ht: TM-03/TE-16,TU-45, 

tunefs: 


topen, tclose, tread, 

file: determine file 

stab: symbol table 

types: primitive system data 


script: make 

man: macros to 

eqn, neqn, checkeq: 

troff, nroff: text formatting and 


uda: 


getpw: get name from 


login, read, readonly, set, shift, times, trap, 
mount, 
mount, 


compress, 
ul: do 
expand, 


uu: TUS8/DECtape II 


up: 
ut: 


mktemp: make a 

gethostid, sethostid: get/set 

flush: flush output to a logical 

fseek, ftell: reposition a file on a logical 

getc, fgetc: get a character from a logical 

putc, fputc: write a character to a fortran logical 
dn: DN-11 autocall 


learn: computer aided instruction about 
reboot: 

system: execute a 

uux: unix to 

uucp: unix to 
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troff width table for a font. 
tropical adventure game. 
trpfpe, fpecnt: trap and repair floating point 
trpt: transliterate protocol trace. 
trsp: transliterate sequenced packet protocol 
true, false: provide truth values. 
true: provide truth values. 
truncate a file to a specified length. 
truncate: truncate a file to a specified length. 
truth values. 
truth values. 
ts: TS-11 magtape interface. 
TS-11 magtape interface. 
tset: terminal dependent initialization. 
tskipf, tstate: [77 tape I/O. 
tsort: topological sort. 
tstate: £77 tape I/O. 
tty: general terminal interface. 
tty: get terminal name. 
ttynam, isatty: find name of a terminal port. 
ttyname, isatty, ttyslot: find name of a terminal. 
ttys file entry. 
ttys: terminal initialization data. 
ttyslot: find name of a terminal. 
tu: VAX-11/730 and VAX-11/750 TUS58 console cassette 
TU45 tri-density tape drive interface. 
TU-45,TU-77 MASSBUS magtape interface. 
TUS8 console cassette interface. 
TU58/DECtape II UNIBUS cassette interface. 
TU-77 MASSBUS magtape interface. 
tune up an existing file system. 
tunefs: tune up an existing file system. 
twrite, trewin, tskipf, tstate: {77 tape I/O. 
type. 


TYPESS  nS2 ve el cee Teepe as Ye Se Ses ce aw Sl] Ves Soe RSD Re Se 
types: primitive system data types. 
typescript of terminal session. 
typeset manual. 
typeset mathematics. 
typesetting. 
ualarm: schedule signal after specified time. 
uda: UDA-50 disk controller interface. 
UDA-50 disk controller interface. 
udp: Internet User Datagram Protocol. 
uid. 
ul: do underlining. 
umask: change or display file creation mask. 
umask: set file creation mode mask. 
umask, wait: command language. /exec, exit, export, 
umount: mount and dismount file system. 
umount: mount or remove file system. 
unalias: remove aliases. 
uncompress, zcat: compress and expand data. 
underlining. 
unexpand: expand tabs to spaces, and vice versa. 
ungetc: push character back into input stream. 
unhash: discard command hash table. 
UNIBUS cassette interface. 
unibus storage module controller/drives. 
UNIBUS TU4S tri-density tape drive interface. 
unifdef: remove ifdef’ ed lines. 
uniq: report repeated lines in a file. 
unique file name. 
unique identifier of current host. 
unit. 


unit interface. 
units: conversion program. 
UNIX. 
UNIX bootstrapping procedures. 
UNIX command. 
unix command execution. 
unix copy. 
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vwidth(1) 
battlestar(6) 
trpfpe(3F) 
trpt(8C) 
trsp(8C) 
true(1) 
false(1) 
truncate(2) 
truncate(2) 
false(1) 
true(1) 
ts(4) 

ts(4) 
tset(1) 
topen(3F) 
tsort(1) 
topen(3F) 
tty(4) 
tty(1) 
ttynam(3F) 
ttyname(3) 
getttyent(3) 
ttys(5) 
ttyname(3) 
tu(4) 

ut(4) 

ht(4) 

tu(4) 

uu(4) 

ht(4) 
tunefs(8) 
tunefs(8) 
topen(3F) 
file(1) 
stab(5) 
types(5) 
types(5) 
script(1) 
man(7) 
eqn(1) 
troff(1) 
ualarm(3) 
uda(4) 
uda(4) 
udp(4P) 
getpw(3C) 
ul(1) 
esh(1) 
umask(2) 
sh(1) 
mount(8) 
mount(2) 
esh(1) 
compress(1) 
ul(1) 
expand(1) 
ungetc(3S) 


uniq(1) 
mktemp(3) 
gethostid(2) 
flush(3F) 
fseek(3F) 
getc(3F) 
putc(3F) 
dn(4) 
units(1) 
learn(1) 
reboot(8) 
system(3F) 
uux(1C) 
uucp(1C) 
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mtio: 
uUux: 
uucp: 


rmdir, rm: remove 
rm, rmdir: remove 


uptime: show how long system has been 
tunefs: tune 


touch: 


sync: 
sync: 
update: periodically 


du: summarize disk 

quota: display disc 

what: show what versions of object modules were 
miscellaneous: miscellaneous 

login: login new 

talk: talk to another 

write: write to another 

seteuid, setruid, setgid, setegid, setrgid: set 
talkd: remote 

udp: Internet 

environ: 

whoami: print effective current 

su: substitute 

getuid, geteuid: get 

setreuid: set real and effective 

finger: 

fingerd: remote 

telnet: 

whois: DARPA Internet 

getuid, getgid: get 

edquota: edit 

getusershell, setusershell, endusershell: get legal 


adduser: procedure for adding new 
binmail: send or receive mail among 
wall: write to all 

last: indicate last logins of 


getlog: get 
users: compact list of 


getrusage: get information about resource 
vtimes: get information about resource 


uux. 


rmail: handle remote mail received via 
L-devices: 

uuxdt: 

L.aliases: 

uuname: list names of 

uulog: display 

uucico, uucpd: transfer files queued by 
USERFILE: 

L-dialcodes: 

uuq: examine or manipulate the 
L.cmds: 

L.sys: 

uupoll: poll a remote 

uuclean: 

uusnap: show snapshot of the 


uucico, 
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UNIX magtape interface. 
unix to unix command execution. 
unix to unix copy. 
unlimit: remove resource limitiations. 
(unlink) directories or files. 
(unlink) files or directories. 
unlink: remove a directory entry. 
unlink: remove directory entry. 

unset: discard shell variables. . 2... 2... 2. eee 
unsetenv: remove environment variables. 
up. 
up an existing file system. 
up: unibus storage module controller/drives. 
update date last modified of a file. 
update: periodically update the super block. 
update super-block. 
update the super block. 
update the super block. 
uptime: show how long system has been up. 
usage. 
usage and limits. 
used to construct a file. 

useful information pages. 
user. 


USELESS oe S950 cow cS so het, WO fa MS Siac ONES A (DMG, DAS, NE a OPS 38 
user and group ID. setuid, 
user communication server. 
User Datagram Protocol. 
user environment. 
USGL AGS - Gee 6, ~ 5 os narcibs Aes 6. SATE wees’ Gaels Le Senate? “aa ae %S, Cates ve 
user id temporarily. 
user identity. 
USCC TD S355, <8 ca nate SS Sg eee BS Las heel ee eB. ae 
user information lookup program. 
user information server. . 2... 6 ee ee ee ee ee 
user interface to the TELNET protocol. 
user name directory service. 
user or group ID of the caller. 
user quotas. 
user shells. 


USELS: fas G6n 2k ee b al Sh G ae ENEG e S 
USETSs- *“ssy cena REN ae Sas oes Peale Puree eae oe ave neds 
users and teletypes. 
users: compact list of users who are on the system. 
user’s login name. 
users who are on the system. 
usleep: suspend execution for interval. 
ut: UNIBUS TU45S tri-density tape drive interface. 
utilization. 
WET AAUON <p AP ON SN Am ee Geeta ES Sb Ee Saha GORA Te Se Mai TS 
utime: set file times. 
utimes: set filetimes. 2... 2... ee ee ee ee ee 
utmp, wtmp: login records. 
uu: TU58/DECtape II UNIBUS cassette interface. 
uucico, uucpd: transfer files queued by uucp or 

uuclean: uucp spool directory clean-up. 
uucp. 
UUCP device description file. 
UCP execution file interpreter. 
UCP hostname alias file. 
UCP hosts. 
U 
Cc 


CP log files. 
p or uux. 
CP pathname permissions file. 
CP phone number index file. 
ucp queue. 
UUCP remote command permissions file. 
UUCP remote host description file. 
UUCP site. 

uucp spool directory clean-up. 
UUCP system. 
uucp: unix to unix copy. 
uucpd: transfer files queued by uucp or uux. 


U 
U 
U 
U 
uu 
UU 
UUCP phone number index file. . 2... .. 2... 502s 
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mtio(4) 
uux(1C) 
uucp(1C) 
esh(1) 
rmdir(1) 
rm(1) 
unlink(3F) 
unlink(2) 
csh(1) 
esh(1) 
uptime(1) 
tunefs(8) 
up(4) 
touch(1) 
update(8) 
sync(2) 
sync(8) 
update(8) 
uptime(1) 
du(1) 
quota(1) 
what(1) 
intro(7) 
csh(1) 
talk(1) 
write(1) 
setuid(3) 
talkd(8C) 
udp(4P) 
environ(7) 
whoami(1) 
su(1) 
getuid(2) 
setreuid(2) 
finger(1) 
fingerd(8C) 
telnet(1C) 
whois(1) 
getuid(3F) 
edquota(8) 
getusershell(3) 
USERFILE(5) 
adduser(8) 
binmail(1) 
wall(1) 
last(1) 
users(1) 
getlog(3F) 
users(1) 
usleep(3) 
ut(4) 
getrusage(2) 
vtimes(3C) 
utime(3C) 
utimes(2) 
utmp(5) 
uu(4) 
uucico(8C) 
uuclean(8C) 
rmail(1) 
L-devices(5) 
uuxqt(8C) 
L.aliases(5) 
uuname(1C) 
uulog(1C) 
uucico(8C) 
USERFILE(5) 
L-dialcodes(5) 
uuq(1C) 
L.cmds(5) 
L.sys(5) 
uupoll(8C) 
uuclean(8C) 
uusnap(8C) 
uucp(1C) 
uucico(8C) 
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transmission via mail. uuencode, 
uuencode: format of an encoded 


transmission via mail. 


uucico, uucpd: transfer files queued by uucp or 


vacation: return ‘‘I am on 


abs: integer absolute 

hypot, cabs: Euclidean distance, complex absolute 
functions. fabs, floor, ceil, rint: absolute 
getenv: 

readlink: read 

getenv: get 

getitimer, setitimer: get/set 

set: change 

false, true: provide truth 

dflmin, dflmax, dffrac, inmax: return extreme 
rand, drand, irand: return random 

true, false: provide truth 

htonl, htons, ntohl, ntohs: convert 


set: change value of shell 

varargs: 

setenv: set 

@: arithmetic on shell 

unset: discard shell 

unsetenv: remove environment 

getenv: get value of environment 

erl: 

signals invalid floating-point operations on a 
as: 

cons: 

interface. tu: 

tu: VAX-11/730 and 

assert: program 

lint: a C program 

expand, unexpand: expand tabs to spaces, and vice 
vfont: font formats for the Benson-Varian or 
vp: 

hangman: Computer 

file. what: show what 

Versatec. 

efficient way. 


verindefs: 

terminal. 

on ex. 

encode/decode a binary file for transmission 
rmail: handle remote mail received 

expand, unexpand: expand tabs to spaces, and 
more, page: file perusal filter for crt 

robots: fight off 


vfork: spawn new process in a 

vmstat: report 

vhangup: 

vi: screen oriented 

consumption. 

vtroff, or troff. 

tn3270: full-screen remote login to IBM 


fs, inode: format of file system 
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uudecode: encode/decode a binary file for 
uuencode file. 
uuencode: format of an encoded uuencode file. 
uuencode, uudecode: encode/decode a binary file for 
uulog: display UUCP log files. 
uuname: list names of UUCP hosts. 
uupoll: poll a remote UUCP site. 
uuq: examine or manipulate the uucp queue. 
uusend: send a file to a remote host. 
uusnap: show snapshot of the UUCP system. 
uux. 
uux: unix to unix command execution. 
uuxqt: UUCP execution file interpreter. 
va: Benson-Varian interface. 
vacation’’ indication. 
vacation: return ‘‘I am on vacation’’ indication. 
valloc: aligned memory allocator. 
value. 
value. 
value, floor, ceiling, and round-to-nearest 
value for environment name. 
value of a symbolic link. 
value of environment variables. 
value of interval timer. 
value of shell variable. 
values. 
values. fimin, flmax, ffrac, 
values. 
values. 
values between host and network byte order. 
varargs: variable argument list. 
variable. 
variable argument list. 
variable in environment. 
variables. 
variables. 
variables. 
variables. 
VAX 8600 console RLO2 interface. 
VAX (temporary). infnan: 
VAX-11 assembler. 
VAX-11 console interface. 
VAX-11/730 and VAX-11/750 TUS8 console cassette 
VAX-11/750 TUS8 console cassette interface. 
verification. 
verifier. 
versa. 
Versatec. 
Versatec interface. 
version of the game hangman. 
versions of object modules were used to construct a 
vfont: font formats for the Benson-Varian or 
vfork: spawn new process in a virtual memory 
verind: grind nice listings of programs. 
vgrindefs: vgrind’s language definition data base. 
verind’s language definition data base. 
vhangup: virtually ‘‘hangup’’ the current control 
vi: screen oriented (visual) display editor based 
via mail. uuencode, uudecode: 
via uucp. 
vice versa. 
viewing. 
villainous robots. 
vipw: edit the password file. 
virtual memory efficient way. 
virtual memory statistics. 
virtually ‘‘hangup’’ the current control terminal. 
(visual) display editor based on ex. 
vlimit: control maximum system resource 
vip: Format Lisp programs to be printed with nroff, 
VM/CMS. 
vmstat: report virtual memory statistics. 
vnews: read news articles. 
volume. 
vp: Versatec interface. 
vtimes: get information about resource utilization. 
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uuencode(1C) 
uuencode(5) 
uuencode(5) 
uuencode(1C) 
uulog(1C) 
uuname(1C) 
uupoll(8C) 
uuq(1C) 
uusend(1C) 
uusnap(8C) 
uucico(8C) 
uux(1C) 
uuxqt(8C) 
va(4) 
vacation(1) 
vacation(1) 
valloc(3C) 
abs(3) 
hypot(3M) 
floor(3M) 
getenv(3) 
readlink(2) 
getenv(3F) 
getitimer(2) 
esh(1) 
false(1) 
fimin(3F) 
rand(3F) 
true(1) 
byteorder(3N) 
varargs(3) 
esh(1) 
varargs(3) 
esh(1) 
esh(1) 
esh(1) 
esh(1) 
getenv(3F) 
crl(4) 
infnan(3M) 
as(1) 
cons(4) 
tu(4) 

tu(4) 
assert(3) 
lint(1) 
expand(1) 
vfont(5) 
vp(4) 
hangman(6) 
what(1) 
vfont(5) 
vfork(2) 
verind(1) 
verindefs(5) 
verindefs(5) 
vhangup(2) 
vi(1) 
uuencode(1C) 
rmail(1) 
expand(1) 
more(1) 
robots(6) 
vipw(8) 
vfork(2) 
vmstat(1) 
vhangup(2) 
vi(1) 
vlimit(3C) 
vip(1) 
tn3270(1) 
vmstat(1) 
vnews(1) 
fs(5) 

vp(4) 
vtimes(3C) 
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vlp: Format Lisp programs to be printed with nroff, 


read, readonly, set, shift, times, trap, umask, 
wait: 

wait: 

sigpause: atomically release blocked signals and 
wait, wait3: 


wait, 
atq: print the queue of jobs 


what: show what versions of object modules 
whatis: describe 

crash: 

used to construct a file. 

w: who is on and 

construct a file. what: show 


crash: what happens 

leave: remind you 

program. 

paths (csh only). 

exec, exit, export, login,/ sh, for, case, if, 


break: exit 

users: compact list of users 

from: 

w: 

who: 

biff: be notified if mail arrives and 


rwho: 

fold: fold long lines for finite 
vwidth: make troff 

window: 


fastboot, fasthalt: reboot/halt the system 
sail: multi-user 

we: 

getc, getchar, fgetc, getw: get character or 
putc, putchar, fputc, putw: put character or 
diction, explain: print 

cd: change 

chdir: change current 

getcwd: get pathname of current 

pwd: 

getwd: get current 

worm: Play the growing 


worms: animate 
putc, fpute: 
write, writev: 
wall: 

write: 


write, 
open: open a file for reading or 
utmp, 


ddn: DDN Standard Mode 
en: 

idp: 

ns: 

ns_addr, ns_ntoa: 

spp: 

xsend, 
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vtroff, or troff. 

vv: Proteon proNET 10 Megabit ring. 
vwidth: make troff width table for a font. 
w: who is on and what they are doing. 
wait: await completion of process. 


wait: command language. /exec, exit, export, login, 


wait for a process to terminate. 

wait for background processes to eomplete, 

wait for interrupt. 

wait for process to terminate. 

wait: wait for a process to terminate. 

wait: wait for background processes to complete, 
wait, wait3: wait for process to terminate. 

wait3: wait for process to terminate. 

waiting to be run. 

wall: write to all users. 

we: word count. Spee 

were used to construct a file. 

what a command is. : 

what happens when the system cashes 

what: show what versions of ane modules were 
what they are doing. 

what versions of object moiiiles: were eased ‘6 
whatis: describe what a command is. 

when the system crashes. 

when you have to leave. ‘ 
whereis: locate source, binary, sd or snnnital for 
which: locate a program file including aliases and 
while, :, . , break, continue, cd, eval, 

while: repeat commands conditionally. 
while/foreach loop. 

who are on the system. 

who is my mail from?. F 

who is on and what they are dame: 

who is on the system. 

who it is from. is 

who: who is on the System 

whoami: print effective current user ie 


whois: DARPA Internet user name directory service. 


who’s logged in on local machines. 

width output device. 

width table for a font. 

window environment. 

window: window environment. 

without checking the disks. 

wooden ships and iron men. 

word count. 

word from stream. 

word on a stream. ‘ 
wordy sentences; hesaneas: fos diction: 
working directory. 

working directory. 

working directory. 

working directory name. 

working directory isi 

worm game. 

worm: Play the comin worm eae, 
worms: animate worms on a display terminal. 
worms on a display terminal. 3 
write a character to a fortran logical unit. 
write output. 

write to all users. 

write to another user. 

write: write to another user. 

write, writev: write output. 

writev: write output. 

writing, or create a new file. 

wtmp: login records. 

wump: the game of hunt-the- ayrinapties 

X.25 IMP interface. F 

Xerox 3 Mb/s Ethernet interface. 

Xerox Internet Datagram Protocol. . 
Xerox Network Systems(tm) protocol fatnily, 
Xerox NS(tm) address conversion routines. 
Xerox Sequenced Packet Protocol. 

xget, enroll: secret mail. 
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vip(1) 
vv(4) 
vwidth(1) 
w(1) 
wait(1) 
sh(1) 
wait(3F) 
esh(1) 
sigpause(2) 
wait(2) 
wait(3F) 
esh(1) 
wait(2) 
wait(2) 
atq(1) 
wall(1) 
we(1) 
what(1) 
whatis(1) 
crash(8V) 
what(1) 
w(1) 
what(1) 
whatis(1) 
crash(8V) 
leave(1) 
whereis(1) 
which(1) 
sh(1) 
esh(1) 
esh(1) 
users(1) 
from(1) 
w(1) 
who(1) 
biff(1) 
who(1) 
whoami(1) 
whois(1) 
rwho(1C) 
fold(1) 
vwidth(1) 
window(1) 
window(1) 
fastboot(8) 
sail(6) 
we(1) 
getc(3S) 
putc(3S) 
diction(1) 
cd(1) 
chdir(2) 
getcwd(3F) 
pwd(1) 
getwd(3) 
worm(6) 
worm(6) 
worms(6) 
worms(6) 
putc(3F) 
write(2) 
wall(1) 
write(1) 
write(1) 
write(2) 
write(2) 
open(2) 
utmp(5) 
wump(6) 
ddn(4) 
en(4) 
idp(4P) 
ns(4F) 
ns(3N) 
spp(4P) 
xsend(1) 
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bit: and, or, 
shared strings. 
JO, jl, jn, 

jO, j1, jn, yO, 


JO, j1, jn, yO, yl, 
compress, uncompress, 


XNSrouted: NS Routing Information Protocol daemon. 


xor, not, rshift, Ishift bitwise functions. ..... 
xsend, xget, enroll: secretmail. ........ 
xstr: extract strings from C programs to implement 

yO, yl, yn: bessel functions. ......... 
yl, yn: bessel functions. ..........-. 
yacc: yet another compiler-compiler. ...... 
yes: be repetitively affirmative. ........ 
yn: bessel functions. ...........-. 
zcat: compress andexpanddata. ........ 
zork: the game of dungeon. . ......... 
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NAME 
intro — introduction to commands 


DESCRIPTION 
This section describes publicly accessible commands in alphabetic order. Certain distinctions of purpose 
are made in the headings: 


(1) Commands of general utility. 
(1C) Commands for communication with other systems. 
(1G) Commands used primarily for graphics and computer-aided design. 


N.B.: Commands related to system maintenance used to appear in section 1 manual pages and were distin- 
guished by (1M) at the top of the page. These manual pages now appear in section 8. 


SEE ALSO 
Section (6) for computer games. 


How to get started, in the Introduction. 


DIAGNOSTICS 
Upon termination each command returns two bytes of status, one supplied by the system giving the cause 
for termination, and (in the case of ‘normal’ termination) one supplied by the program, see wait and exit(2). 
The former byte is 0 for normal termination, the latter is customarily 0 for successful execution, nonzero to 
indicate troubles such as erroneous parameters, bad or inaccessible data, or other inability to cope with the 
task at hand. It is called variously ‘exit code’, ‘exit status’ or ‘return code’, and is described only where 
special conventions are involved. 
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NAME 
adb — debugger 


SYNOPSIS 
adb [-w] [ -k ] [ -Idir ] [ objfil [ corfil ] ] 


DESCRIPTION 
Adb is a general purpose debugging program. It may be used to examine files and to provide a controlled 
environment for the execution of UNIX programs. 


Objfil is normally an executable program file, preferably containing a symbol table; if not then the symbolic 
features of adb cannot be used although the file can still be examined. The default for objfil is a.out. Corfil 
is assumed to be a core image file produced after executing objfil; the default for corfil is core. 


Requests to adb are read from the standard input and responses are to the standard output. If the —w flag is 
present then both objfil and corfil are created if necessary and opened for reading and writing so that files 
can be modified using adb. 


The -k option makes adb do UNIX kernel memory mapping; it should be used when core is a UNIX crash 
dump or /dev/mem. 


The -I option specifies a directory where files to be read with $< or $<< (see below) will be sought; the 
default is /usr/lib/adb . 


Adb ignores QUIT; INTERRUPT causes return to the next adb command. 
In general requests to adb are of the form 
[ address | [, count | [command ]|[;] 


If address is present then dot is set to address. Initially dot is set to 0. For most commands count specifies 
how many times the command will be executed. The default count is 1. Address and count are expres- 
sions. 


The interpretation of an address depends on the context it is used in. If a subprocess is being debugged then 
addresses are interpreted in the usual way in the address space of the subprocess. If the operating system is 
being debugged either post-mortem or using the special file /dev/mem to interactive examine and/or modify 
memory the maps are set to map the kernel virtual addresses which start at Ox80000000 (on the VAX). 
ADDRESSES. 


EXPRESSIONS 
The value of dot. 


+ The value of dot incremented by the current increment. 


A 


The value of dot decremented by the current increment. 
" The last address typed. 


integer A number. The prefixes 0o and OO (‘‘zero oh’’) force interpretation in octal radix; the prefixes Ot 
and OT force interpretation in decimal radix; the prefixes Ox and OX force interpretation in hex- 
adecimal radix. Thus 0020 = 0t16 = 0x10 = sixteen. If no prefix appears, then the default radix is 
used; see the $d command. The default radix is initially hexadecimal. The hexadecimal digits are 
0123456789abcdefABCDEF with the obvious values. Note that a hexadecimal number whose 
most significant digit would otherwise be an alphabetic character must have a Ox (or 0X) prefix (or 
a leading zero if the default radix is hexadecimal). 


integer fraction 
A 32 bit floating point number. 


‘cccc” The ASCII value of up to 4 characters. \ may be used to escape a *. 


<name_ The value of name, which is either a variable name or a register name. Adb maintains a number of 
variables (see VARIABLES) named by single letters or digits. If name is a register name then the 
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value of the register is obtained from the system header in corfil. The register names are those 
printed by the $r command. 


symbol A symbol is a sequence of upper or lower case letters, underscores or digits, not starting with a 
digit. The backslash character \ may be used to escape other characters. The value of the symbol 
is taken from the symbol table in objfil. An initial _ will be prepended to symbol if needed. 


_ symbol 
In C, the ‘true name’ of an external symbol begins with . It may be necessary to utter this name 
to distinguish it from internal or hidden variables of a program. 


routine name 
The address of the variable name in the specified C routine. Both routine and name are symbols. 
If name is omitted the value is the address of the most recently activated C stack frame corre- 
sponding to routine. (This form is currently broken on the VAX; local variables can be examined 
only with dbx(1).) 


(exp) The value of the expression exp. 

Monadic operators 

*exp The contents of the location addressed by exp in corfil. 
@exp The contents of the location addressed by exp in objfil. 
-exp Integer negation. 

~exp Bitwise complement. 

#exp Logical negation. 

Dyadic operators are left associative and are less binding than monadic operators. 
el+e2 Integer addition. 

el-e2 Integer subtraction. 

el*e2 Integer multiplication. 

el%e2 Integer division. 

el&e2 Bitwise conjunction. 

elle2  Bitwise disjunction. 

el#e2 EJ rounded up to the next multiple of e2. 


COMMANDS 
Most commands consist of a verb followed by a modifier or list of modifiers. The following verbs are 
available. (The commands ‘?’ and ‘/’ may be followed by ‘*’; see ADDRESSES for further details.) 


of Locations starting at address in objfil are printed according to the format f. dot is incremented by 
the sum of the increments for each format letter (q.v.). 


/f Locations starting at address in corfil are printed according to the format f and dot is incremented 
as for ‘?’. 
=f The value of address itself is printed in the styles indicated by the format f. (For i format ‘?’ is 


printed for the parts of the instruction that reference subsequent words.) 


A format consists of one or more characters that specify a style of printing. Each format character may be 
preceded by a decimal integer that is a repeat count for the format character. While stepping through a for- 
mat dot is incremented by the amount given for each format letter. If no format is given then the last for- 
mat is used. The format letters available are as follows. 


o 2 Print 2 bytes in octal. All octal numbers output by adb are preceded by 0. 


4th Berkeley Distribution April 29, 1985 2 


ADB (1) UNIX Programmer’s Manual ADB (1) 


Print 4 bytes in octal. 

Print in signed octal. 

Print long signed octal. 

Print in decimal. 

Print long decimal. 

Print 2 bytes in hexadecimal. 

Print 4 bytes in hexadecimal. 

Print as an unsigned decimal number. 

Print long unsigned decimal. 

Print the 32 bit value as a floating point number. 

Print double floating point. 

Print the addressed byte in octal. 

Print the addressed character. 

Print the addressed character using the standard escape convention where control charac- 
ters are printed as *X and the delete character is printed as *?. 

Print the addressed characters until a zero character is reached. 

Print a string using the “X escape convention (see C above). n is the length of the string 
including its zero terminator. 

Y 4 Print 4 bytes in date format (see ctime(3)). 

Print as machine instructions. n is the number of bytes occupied by the instruction. This 
style of printing causes variables | and 2 to be set to the offset parts of the source and 
destination respectively. 

a 0 Print the value of dot in symbolic form. Symbols are checked to ensure that they have an 
appropriate type as indicated below. 


Qe emt ae MK pA OL O 
RereroohFNANANAN SFE 


Nu 
a) 


- 
5 


/ local or global data symbol 
? local or global text symbol 
= local or global absolute symbol 


p 4 Print the addressed value in symbolic form using the same rules for symbol lookup as a. 
0 When preceded by an integer tabs to the next appropriate tab stop. For example, 8t 
moves to the next 8-space tab stop. 
Print a space. 
n 0 Print a newline. 
",..'"0 Print the enclosed string. 
Dot is decremented by the current increment. Nothing is printed. 
+ Dot is incremented by 1. Nothing is printed. 
- Dot is decremented by 1. Nothing is printed. 


* 


+ 
o 


newline Repeat the previous command with a count of 1. 


[2/]l value mask 
Words starting at dot are masked with mask and compared with value until a match is found. If L 
is used then the match is for 4 bytes at a time instead of 2. If no match is found then dot is 
unchanged; otherwise dot is set to the matched location. If mask is omitted then —1 is used. 


[?/]w value ... 
Write the 2-byte value into the addressed location. If the command is W, write 4 bytes. Odd 
addresses are not allowed when writing to the subprocess address space. 


[?/Jm bi el f1[?/] 
New values for (b/, e/, f1) are recorded. If less than three expressions are given then the remain- 
ing map parameters are left unchanged. If the ‘?’ or ‘/ is followed by ‘*’ then the second segment 
(b2 ,e2 , f2) of the mapping is changed. If the list is terminated by ‘?’ or ‘/ then the file (objfil or 
corfil respectively) is used for subsequent requests. (So that, for example, ‘/m?’ will cause ‘/’ to 
refer to objfil.) 
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>name_ Dot is assigned to the variable or register named. 


! A shell (/bin/sh) is called to read the rest of the line following ‘!’. 


$modifier 


Miscellaneous commands. The available modifiers are: 


<f 


<<f 


ao 


wEa<nourdo 


:modifier 


Read commands from the file f. If this command is executed in a file, further commands 
in the file are not seen. If fis omitted, the current input stream is terminated. If a count is 
given, and is zero, the command will be ignored. The value of the count will be placed in 
variable 9 before the first command in fis executed. 

Similar to < except it can be used in a file of commands without causing the file to be 
closed. Variable 9 is saved during the execution of this command, and restored when it 
completes. There is a (small) finite limit to the number of << files that can be open at 
once. 

Append output to the file f, which is created if it does not exist. If fis omitted, output is 
returned to the terminal. 

Print process id, the signal which caused stoppage or termination, as well as the registers 
as $r. This is the default if modifier is omitted. 

Print the general registers and the instruction addressed by pe. Dot is set to pe. 

Print all breakpoints and their associated counts and commands. 

C stack backtrace. If address is given then it is taken as the address of the current frame 
instead of the contents of the frame—pointer register. If C is used then the names and (32 
bit) values of all automatic and static variables are printed for each active function. (bro- 
ken on the VAX). If count is given then only the first count frames are printed. 

Set the default radix to address and report the new value. Note that address is interpreted 
in the (old) current radix. Thus ‘‘10$d’’ never changes the default radix. To make deci- 
mal the default radix, use ‘‘Ot10$d’’. 

The names and values of external variables are printed. 

Set the page width for output to address (default 80). 

Set the limit for symbol matches to address (default 255). 

All integers input are regarded as octal. 

Exit from adb. 

Print all non zero variables in octal. 

Print the address map. 

(Kernel debugging) Change the current kernel memory mapping to map the designated 
user structure to the address given by the symbol _u. The address argument is the 
address of the user’s user page table entries (on the VAX). 


Manage a subprocess. Available modifiers are: 


be 


cs 
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Set breakpoint at address. The breakpoint is executed count—1 times before causing a 
stop. Each time the breakpoint is encountered the command c is executed. If this com- 
mand is omitted or sets dot to zero then the breakpoint causes a stop. 


Delete breakpoint at address. 


Run objfil as a subprocess. If address is given explicitly then the program is entered at 
this point; otherwise the program is entered at its standard entry point. count specifies 
how many breakpoints are to be ignored before stopping. Arguments to the subprocess 
may be supplied on the same line as the command. An argument starting with < or > 
causes the standard input or output to be established for the command. 


The subprocess is continued with signal s, see sigvec(2). If address is given then the sub- 
process is continued at this address. If no signal is specified then the signal that caused 
the subprocess to stop is sent. Breakpoint skipping is the same as for r. 
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ss As for ¢ except that the subprocess is single stepped count times. If there is no current 
subprocess then objfil is run as a subprocess as for r. In this case no signal can be sent; 
the remainder of the line is treated as arguments to the subprocess. 


k The current subprocess, if any, is terminated. 


VARIABLES 


Adb provides a number of variables. Named variables are set initially by adb but are not used subse- 
quently. Numbered variables are reserved for communication as follows. 


0 The last value printed. 

1 The last offset part of an instruction source. 
2 The previous value of variable 1. 

9 The count on the last $< or $<< command. 


On entry the following are set from the system header in the corfil. If corfil does not appear to be a core 
file then these values are set from objfil. 


b The base address of the data segment. 
d The data segment size. 
e The entry point. 
m The ‘magic’ number (0407, 0410 or 0413). 
S The stack segment size. 
t The text segment size. 
ADDRESSES 


The address in a file associated with a written address is determined by a mapping associated with that file. 
Each mapping is represented by two triples (b/, e/, f1) and (b2, e2, f2) and the file address corresponding 
to a written address is calculated as follows. 


b1saddress<el => file address=address+fl—b1, otherwise, 
b2<address<e2 = file address=address+f2—b2, 


otherwise, the requested address is not legal. In some cases (e.g. for programs with separated I and D 
space) the two segments for a file may overlap. If a ? or / is followed by an * then only the second triple is 
used. 


The initial setting of both mappings is suitable for normal a.out and core files. If either file is not of the 
kind expected then, for that file, b/ is set to 0, e/ is set to the maximum file size and f7/ is set to 0; in this 
way the whole file can be examined with no address translation. 


FILES 
a.out 
core 
SEE ALSO 


cc(1), dbx(1), ptrace(2), a.out(5), core(5) 


DIAGNOSTICS 


BUGS 


“Adb’ when there is no current command or format. Comments about inaccessible files, syntax errors, 
abnormal termination of commands, etc. Exit status is 0, unless last command failed or returned nonzero 
status. 


Since no shell is invoked to interpret the arguments of the :r command, the customary wild-card and vari- 
able expansions cannot occur. 
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NAME 


addbib — create or extend bibliographic database 


SYNOPSIS 


addbib [-p promptfile ] [-a] database 


DESCRIPTION 


665,99 


When this program starts up, answering ‘‘y’’ to the initial “‘Instructions?’’ prompt yields directions; typing 
“‘n’’? or RETURN skips them. Addbib then prompts for various bibliographic fields, reads responses from the 
terminal, and sends output records to a database. A null response (just RETURN) means to leave out that 
field. A minus sign (—) means to go back to the previous field. A trailing backslash allows a field to be 
continued on the next line. The repeating “‘Continue?’’ prompt allows the user either to resume by typing 


y’’ or RETURN, to quit the current session by typing “‘n’’ or “‘q’’, or to edit the database with any system 
editor (vi, ex, edit, ed). 


The —a option suppresses prompting for an abstract; asking for an abstract is the default. Abstracts are 
ended with a CTRL-d. The —-p option causes addbib to use a new prompting skeleton, defined in prompftfile. 
This file should contain prompt strings, a tab, and the key-letters to be written to the database. 


The most common key-letters and their meanings are given below. Addbib insulates you from these key- 
letters, since it gives you prompts in English, but if you edit the bibliography file later on, you will need to 
know this information. 


JA Author’s name 

%B Book containing article referenced 
%C City (place of publication) 

%D Date of publication 


%E Editor of book containing article referenced 
%F Footnote number or label (supplied by refer ) 
%G Government order number 

%H Header commentary, printed before reference 
%I Issuer (publisher) 

%oJ Journal containing article 

%K Keywords to use in locating reference 


%L Label field used by -k option of refer 
%M Bell Labs Memorandum (undefined) 


JN Number within volume 

%O Other commentary, printed at end of reference 
%P Page number(s) 

%Q Corporate or Foreign Author (unreversed) 

%R Report, paper, or thesis (unpublished) 

%S Series title 

%T Title of article or book 

%V Volume number 


YoX Abstract — used by roffbib, not by refer 
%Y,Z ignored by refer 


Except for “A’, each field should be given just once. Only relevant fields should be supplied. An example 
is: 


%A Bill Tuthill 
%T Refer — A Bibliography System 


%oI Computing Services 
%C Berkeley 
%D 1982 
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%O UNX 4.3.5. 


FILES 

promptfile optional file to define prompting 
SEE ALSO 

refer(1), sortbib(1), roffbib(1), indxbib(1), lookbib(1) 
AUTHORS 


Al Stangenberger, Bill Tuthill 
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NAME 
apply — apply a command to a set of arguments 


SYNOPSIS 
apply [ -ac ] [-7 ] command args ... 


DESCRIPTION 
Apply runs the named command on each argument arg in turn. Normally arguments are chosen singly; the 
optional number n specifies the number of arguments to be passed to command. If n is zero, command is 
run without arguments once for each arg. Character sequences of the form %d in command, where d is a 
digit from | to 9, are replaced by the d’th following unused arg. If any such sequences occur, n is ignored, 
and the number of arguments passed to command is the maximum value of d in command. The character 
“%’ may be changed by the —a option. 


Examples: 
apply echo * 
is similar to 1s(1); 
apply —2 cmp al bl a2 b2... 
compares the ‘a’ files to the ‘b’ files; 
apply -0 who 12345 
runs who(1) 5 times; and 
apply ‘In %1 /usr/joe’ * 
links all files in the current directory to the directory /usr/joe. 


SEE ALSO 
sh(1) 


AUTHOR 
Rob Pike 


BUGS 
Shell metacharacters in command may have bizarre effects; it is best to enclose complicated commands in 
single quotes ~ * 


There is no way to pass a literal ‘%2’ if “%’ is the argument expansion character. 
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NAME 

apropos — locate commands by keyword lookup 
SYNOPSIS 

apropos keyword ... 
DESCRIPTION 


Apropos shows which manual sections contain instances of any of the given keywords in their title. Each 
word is considered separately and case of letters is ignored. Words which are part of other words are con- 
sidered; thus, when looking for compile, apropos will find all instances of ‘compiler’ also. Try 


apropos password 
and 
apropos editor 


If the line starts ‘name(section) ...” you can do ‘man section name’ to get the documentation for it. Try 
‘apropos format’ and then ‘man 3s printf? to get the manual on the subroutine printf. 


Apropos is actually just the -k option to the man(1) command. 


FILES 

/usr/man/whatis data base 
SEE ALSO 

man(1), whatis(1), catman(8) 
AUTHOR 

William Joy 


7th Edition June 5, 1986 1 


AR(1) 


NAME 
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ar — archive and library maintainer 


SYNOPSIS 


ar key [ posname ] afile name ... 


DESCRIPTION 


Ar maintains groups of files combined into a single archive file. Its main use is to create and update library 
files as used by the loader. It can be used, though, for any similar purpose. N.B: This version of ar uses a 
ASCII-format archive which is portable among the various machines running UNIX. Programs for dealing 
with older formats are available: see arcv(8). 


Key is one character from the set drqtpmx, optionally concatenated with one or more of vuaibclo. Afile is 
the archive file. The names are constituent files in the archive file. The meanings of the key characters are: 


d 


r 


FILES 


Delete the named files from the archive file. 


Replace the named files in the archive file. If the optional character u is used with r, then only 
those files with ‘last-modified’ dates later than the archive files are replaced. If an optional posi- 
tioning character from the set abi is used, then the posname argument must be present and 
specifies that new files are to be placed after (a) or before (b or i) posname. Otherwise new files 
are placed at the end. 


Quickly append the named files to the end of the archive file. Optional positioning characters are 
invalid. The command does not check whether the added members are already in the archive. 
Useful only to avoid quadratic behavior when creating a large archive piece-by-piece. 


Print a table of contents of the archive file. If no names are given, all files in the archive are 
tabled. If names are given, only those files are tabled. 


Print the named files in the archive. 


Move the named files to the end of the archive. If a positioning character is present, then the pos- 
name argument must be present and, as in r, specifies where the files are to be moved. 


Extract the named files. If no names are given, all files in the archive are extracted. In neither case 
does x alter the archive file. Normally the ‘last-modified’ date of each extracted file is the date 
when it is extracted. However, if 0 is used, the ‘last-modified’ date is reset to the date recorded in 
the archive. 


Verbose. Under the verbose option, ar gives a file-by-file description of the making of a new 
archive file from the old archive and the constituent files. When used with t, it gives a long listing 
of all information about the files. When used with p, it precedes each file with a name. 


Create. Normally ar will create afile when it needs to. The create option suppresses the normal 
message that is produced when afile is created. 


Local. Normally ar places its temporary files in the directory /tmp. This option causes them to be 
placed in the local directory. 


/tmp/v* temporaries 


SEE ALSO 


lorder(1), ld(1), ranlib(1), ar(5), arcv(8) 


BUGS 


If the same file is mentioned twice in an argument list, it may be put in the archive twice. 


The ‘last-modified’ date of a file will not be altered by the o option if the user is not the owner of the 
extracted file, or the super-user. 
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NAME 
as — VAX-11 assembler 


SYNOPSIS 

as [ -al-16 ] [[ -d124][-L ][-W][-V][-J][-R][-+t directory ] [ -o objfile ] [ name... ] 
DESCRIPTION 

As assembles the named files, or the standard input if no file name is specified. The available flags are: 


-a Specifies the alignment of procedures and data blocks. It is given as a power of two; thus an align- 
ment of 3 causes alignment on an eight byte boundary. The default is -a2. 


-d Specifies the number of bytes to be assembled for offsets which involve forward or external refer- 
ences, and which have sizes unspecified in the assembly language. The default is -d4. 


-L Save defined labels beginning with a “L’, which are normally discarded to save space in the resul- 
tant symbol table. The compilers generate such temporary labels. 


-V Use virtual memory for some intermediate storage, rather than a temporary file. 
-W Do not complain about errors. 
-J Use long branches to resolve jumps when byte-displacement branches are insufficient. This must 


be used when a compiler-generated assembly contains branches of more than 32k bytes. 


-R Make initialized data segments read-only, by concatenating them to the text segments. This obvi- 
ates the need to run editor scripts on assembly code to make initialized data read-only and shared. 


-t Specifies a directory to receive the temporary file, other than the default /tmp. 
All undefined symbols in the assembly are treated as global. 


The output of the assembly is left on the file objfile; if that is omitted, a.out is used. 


FILES 
/tmp/as* default temporary files 
a.out default resultant object file 
SEE ALSO 


Id(1), nm(1), adb(1), dbx(1), a.out(5) 
Auxiliary documentation Assembler Reference Manual. 


AUTHORS 
John F. Reiser 
Robert R. Henry 


BUGS 
-J should be eliminated; the assembler should automatically choose among byte, word and long branches. 
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at — execute commands at a later time 


SYNOPSIS 


at[-c][-s ][-m ] time [ day ] [ file ] 


DESCRIPTION 


At spools away a copy of the named file to be used as input to sh(1) or csh(1). If the -e flag (for (csh(1))) 
or the -s flag (for (sh(1))) is specified, then that shell will be used to execute the job; if no shell is specified, 
the current environment shell is used. If no file name is specified, at prompts for commands from standard 
input until a “D is typed. 


If the -m flag is specified, mail will be sent to the user after the job has been run. If errors occur during exe- 
cution of the job, then a copy of the error diagnostics will be sent to the user. If no errors occur, then a short 
message is sent informing the user that no errors occurred. 


The format of the spool file is as follows: A four line header that includes the owner of the job, the name of 
the job, the shell used to run the job, and whether mail will be set after the job is executed. The header is 
followed by a cd command to the current directory and a umask command to set the modes on any files cre- 
ated by the job. Then at copies all relevant environment variables to the spool file. When the script is run, 
it uses the user and group ID of the creator of the spool file. 


The time is 1 to 4 digits, with an optional following ‘A’, ‘P’, ‘N’ or ‘M’ for AM, PM, noon or midnight. 
One and two digit numbers are taken to be hours, three and four digits to be hours and minutes. If no letters 
follow the digits, a 24 hour clock time is understood. 


The optional day is either (1) a month name followed by a day number, or (2) a day of the week; if the word 
‘week’ follows, invocation is moved seven days further off. Names of months and days may be recogniz- 
ably truncated. Examples of legitimate commands are 


at 8am jan 24 
at -c -m 1530 fr week 
at -s -m 1200n week 


At programs are executed by periodic execution of the command /usr/lib/atrun from cron(8). The granular- 
ity of at depends upon the how often atrun is executed. 


Error output is lost unless redirected or the —m flag is requested, in which case a copy of the errors is sent to 
the user via mail(1). 


FILES 
/usr/spool/at spooling area 
/ust/spool/at/yy.ddd.-hhhh.* job file 
/ust/spool/at/past directory where jobs are executed from 
/usr/spool/at/lasttimedone last time atrun was run 
/usr/lib/atrun executor (run by cron(8)) 

SEE ALSO 


atq(1), atrm(1), calendar(1), sleep(1), cron(8) 


DIAGNOSTICS 


BUGS 


Complains about various syntax errors and times out of range. 


Due to the granularity of the execution of /usr/lib/atrun, there may be bugs in scheduling things almost 
exactly 24 hours into the future. 


If the system crashes, mail is not sent to the user informing them that the job was not completed. 


Sometimes old spool files are not removed from the directory /usr/spool/at/past. This is usually due to a 
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system crash, and requires that they be removed by hand. 
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NAME 

atq — print the queue of jobs waiting to be run 
SYNOPSIS 

atq [-c ][-n][ name... ] 
DESCRIPTION 


Atgq prints the queue of jobs that are waiting to be run at a later date. These jobs were created with the at(1) 
command. With no flags, the queue is sorted in the order that the jobs will be executed. 


If the -c flag is used, the queue is sorted by the time that the at command was given. 
The -n flag prints only the total number of files that are currently in the queue. 
If a name(s) is provided, only those files belonging to that user(s) are displayed. 


FILES 
/usr/spool/at spool area 


SEE ALSO 
at(1), atrm(1), cron(8) 
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NAME 
atrm — remove jobs spooled by at 
SYNOPSIS 
atrm [ -f ] [ -i] [-] [[ job #] [name ]... ] 
DESCRIPTION 
Atrm removes jobs that were created with the at(1) command. With the — flag, all jobs belonging to the 


person invoking atrm are removed. If a job number(s) is specified, atrm attempts to remove only that job 
number(s). 


If the -f flag is used, all information regarding the removal of the specified jobs is suppressed. If the -i flag 
is used, atrm asks if a job should be removed; a response of ’y’ causes the job to be removed. 


If a user(s) name is specified, all jobs belonging to that user(s) are removed. This form of invoking atrm is 
useful only to the super-user. 


FILES 
/usr/spool/at spool area 


SEE ALSO 
at(1), atq(1), cron(8) 
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NAME 


awk — pattern scanning and processing language 


SYNOPSIS 


awk [ -Fc ] [ prog ] [ file ] ... 


DESCRIPTION 


Awk scans each input file for lines that match any of a set of patterns specified in prog. With each pattern in 
prog there can be an associated action that will be performed when a line of a file matches the pattern. The 
set of patterns may appear literally as prog, or in a file specified as -f file. 


Files are read in order; if there are no files, the standard input is read. The file name ‘—’ means the standard 
input. Each line is matched against the pattern portion of every pattern-action statement; the associated 
action is performed for each matched pattern. 


An input line is made up of fields separated by white space. (This default can be changed by using FS, vide 
infra.) The fields are denoted $1, $2, ... ; $0 refers to the entire line. 


A pattern-action statement has the form 

pattern { action } 
A missing { action } means print the line; a missing pattern always matches. 
An action is a sequence of statements. A statement can be one of the following: 


if (conditional ) statement [ else statement | 

while ( conditional ) statement 

for ( expression ; conditional ; expression ) statement 
break 

continue 

{ [ statement ] ... } 

variable = expression 

print [ expression-list ] [ >expression ] 

printf format [ , expression-list ] [ >expression ] 
next # skip remaining patterns on this input line 
exit # skip the rest of the input 


Statements are terminated by semicolons, newlines or right braces. An empty expression-list stands for the 
whole line. Expressions take on string or numeric values as appropriate, and are built using the operators +, 
-, *, /, %, and concatenation (indicated by a blank). The C operators ++, —, +=, -=, *=, /=, and %= are 
also available in expressions. Variables may be scalars, array elements (denoted x[i]) or fields. Variables 
are initialized to the null string. Array subscripts may be any string, not necessarily numeric; this allows 


" 


for a form of associative memory. String constants are quoted "...". 


The print statement prints its arguments on the standard output (or on a file if >file is present), separated by 
the current output field separator, and terminated by the output record separator. The printf statement for- 
mats its expression list according to the format (see printf(3S)). 


The built-in function /ength returns the length of its argument taken as a string, or of the whole line if no 
argument. There are also built-in functions exp, log, sqrt, and int. The last truncates its argument to an 
integer. substr(s, m,n) returns the n-character substring of s that begins at position m. The function 
sprintf(fmt, expr, expr, ...) formats the expressions according to the printf(3S) format given by fmt and 
returns the resulting string. 


Patterns are arbitrary Boolean combinations (, ||, &&, and parentheses) of regular expressions and rela- 
tional expressions. Regular expressions must be surrounded by slashes and are as in egrep. Isolated regu- 
lar expressions in a pattern apply to the entire line. Regular expressions may also occur in relational 
expressions. 
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A pattern may consist of two patterns separated by a comma; in this case, the action is performed for all 
lines between an occurrence of the first pattern and the next occurrence of the second. 


A relational expression is one of the following: 


expression matchop regular-expression 
expression relop expression 


where a relop is any of the six relational operators in C, and a matchop is either ~ (for contains) or !~ (for 
does not contain). A conditional is an arithmetic expression, a relational expression, or a Boolean combina- 
tion of these. 


The special patterns BEGIN and END may be used to capture control before the first input line is read and 
after the last. BEGIN must be the first pattern, END the last. 


A single character c may be used to separate the fields by starting the program with 
BEGIN { FS="c" } 
or by using the -Fc option. 


Other variable names with special meanings include NF, the number of fields in the current record; NR, the 
ordinal number of the current record; FILENAME, the name of the current input file; OFS, the output field 
separator (default blank); ORS, the output record separator (default newline); and OFMT, the output format 
for numbers (default "%.6g"). 


EXAMPLES 


Print lines longer than 72 characters: 
length > 72 
Print first two fields in opposite order: 
{ print $2, $1 } 
Add up first column, print sum and average: 


{st+=$1 } 
END __{ print "sum is", s, " average is", s/NR } 


Print fields in reverse order: 
{ for Gi = NF; i> 0; —i) print $3 } 
Print all lines between start/stop pairs: 
/start/, /stop/ 
Print all lines whose first field is different from previous one: 


$1 != prev { print; prev = $1 } 


SEE ALSO 


BUGS 


lex(1), sed(1) 
A. V. Aho, B. W. Kernighan, P. J. Weinberger, Awk — a pattern scanning and processing language 


There are no explicit conversions between numbers and strings. To force an expression to be treated as a 
number add 0 to it; to force it to be treated as a string concatenate "" to it. 
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NAME 

basename — strip filename affixes 
SYNOPSIS 

basename string [ suffix ] 
DESCRIPTION 


Basename deletes any prefix ending in ‘/ and the suffix, if present in string, from string, and prints the 
result on the standard output. It is normally used inside substitution marks ~ ~ in shell procedures. 


This shell procedure invoked with the argument /usr/src/bin/cat.c compiles the named file and moves the 
output to cat in the current directory: 


cc $1 
mv a.out ~basename $1 .c* 


SEE ALSO 
sh(1) 
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NAME 

be — arbitrary-precision arithmetic language 
SYNOPSIS 

be [-c] [-1][ file ... ] 
DESCRIPTION 


Bc is an interactive processor for a language which resembles C but provides unlimited precision arith- 
metic. It takes input from any files given, then reads the standard input. The -l argument stands for the 
name of an arbitrary precision math library. The syntax for bc programs is as follows; L means letter a-z, E 
means expression, S means statement. 


Comments 
are enclosed in /* and */. 


Names 
simple variables: L 
array elements: L [ E ] 
The words ‘ibase’, ‘obase’, and ‘scale’ 


Other operands 
arbitrarily long numbers with optional sign and decimal point. 
(E) 
sqrt (E) 
length (E ) number of significant decimal digits 
scale (E ) number of digits right of decimal point 
L(E,...,E) 


Operators 
+ — * / % ~(% is remainder; * is power) 
++ — (prefix and postfix; apply to names) 
== <= >= I= < > 
ey ee 


Statements 
E 
{S;..3;8} 
if(E)S 
while (E)S 
for(E;E;E)S 
null statement 
break 
quit 

Function definitions 
define L(L,..., L) { 


auto L,..., L 
Si28 
return (E ) 

} 

Functions in -I math library 

s(x) sine 

c(x) cosine 

e(x) exponential 

(x) log 

a(x) arctangent 


j(@,x) —_ Ressel function 
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All function arguments are passed by value. 


The value of a statement that is an expression is printed unless the main operator is an assignment. Either 
semicolons or newlines may separate statements. Assignment to scale influences the number of digits to be 
retained on arithmetic operations in the manner of dc(1). Assignments to ibase or obase set the input and 
output number radix respectively. 


The same letter may be used as an array, a function, and a simple variable simultaneously. All variables are 
global to the program. ‘Auto’ variables are pushed down during function calls. When using arrays as func- 
tion arguments or defining them as automatic variables empty square brackets must follow the array name. 


For example 


scale = 20 
define e(x){ 
auto a, b,c, i, S 
a=1 
b=1 
s=1 
forG=1; 1==1; i++){ 
a=a*x 
b = b*i 
c=a/b 
if(c == 0) return(s) 
S =S+c 


} 

defines a function to compute an approximate value of the exponential function and 
for(i=1; i<=10; i++) e(i) 

prints approximate values of the exponential function of the first ten integers. 


Bc is actually a preprocessor for dc(1), which it invokes automatically, unless the -c (compile only) option 
is present. In this case the dc input is sent to the standard output instead. 


FILES 
/usr/lib/lib.b mathematical library 
dc(1) desk calculator proper 
SEE ALSO 
de(1) 


L. L. Cherry and R. Morris, BC — An arbitrary precision desk-calculator language 


BUGS 
No &&, ||, or ! operators. 
For statement must have all three E’s. 
Quit is interpreted when read, not when executed. 
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NAME 
biff — be notified if mail arrives and who it is from 


SYNOPSIS 
biff [ yn ] 


DESCRIPTION 
Biff informs the system whether you want to be notified when mail arrives during the current terminal ses- 
sion. The command 


biff y 
enables notification; the command 
biff n 


disables it. When mail notification is enabled, the header and first few lines of the message will be printed 
on your screen whenever mail arrives. A ‘‘biff y’’ command is often included in the file ./ogin or .profile to 
be executed at each login. 


Biff operates asynchronously. For synchronous notification use the MAIL variable of sh(1) or the mail 
variable of csh(1). 


SEE ALSO 
csh(1), sh(1), mail(1), comsat(8C) 
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NAME 


binmail — send or receive mail among users 


SYNOPSIS 


/bin/mail [ + ] [-i ] [ person ] ... 
/bin/mail [ + ] [ -i ] -f file 


DESCRIPTION 


FILES 


Note: This is the old version 7 UNIX system mail program. The default mail command is described in 
Mail(1), and its binary is in the directory /usr/ucb. 


mail with no argument prints a user’s mail, message-by-message, in last-in, first-out order; the optional 
argument + displays the mail messages in first-in, first-out order. For each message, it reads a line from the 
standard input to direct disposition of the message. 


newline Go on to next message. 
d Delete message and go on to the next. 
p Print message again. 


- Go back to previous message. 


s [file ]... 


Save the message in the named files (‘mbox’ default). 


w [file ]... 


Save the message, without a header, in the named files (‘mbox’ default). 


m [ person |... 
Mail the message to the named persons (yourself is default). 


EOT (control-D) 
Put unexamined mail back in the mailbox and stop. 


q Same as EOT. 


!command 
Escape to the Shell to do command. 


* Print a command summary. 


An interrupt normally terminates the mail command; the mail file is unchanged. The optional argument —i 
tells mail to continue after interrupts. 


When persons are named, mail takes the standard input up to an end-of-file (or a line with just *.’) and adds 
it to each person’s ‘mail’ file. The message is preceded by the sender’s name and a postmark. Lines that 
look like postmarks are prepended with ‘>’. A person is usually a user name recognized by login(1). To 
denote a recipient on a remote system, prefix person by the system name and exclamation mark (see 
uucp(1C)). 


The -f option causes the named file, for example, ‘mbox’, to be printed as if it were the mail file. 


When a user logs in he is informed of the presence of mail. 


/etc/passwd to identify sender and locate persons 
/usr/spool/mail/* incoming mail for user * 

mbox saved mail 

/tmp/ma* temp file 

/usr/spool/mail/*.lock lock for mail directory 

dead. letter unmailable text 
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SEE ALSO 
Mail(1), write(1), uucp(1C), uux(1C), xsend(1), sendmail(8) 


BUGS 
Race conditions sometimes result in a failure to remove a lock file. 


Normally anybody can read your mail, unless it is sent by xsend(1). An installation can overcome this by 
making mail a set-user-id command that owns the mail directory. 
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NAME 
cal — print calendar 


SYNOPSIS 
cal [ month ] year 


DESCRIPTION 
Cal prints a calendar for the specified year. If a month is also specified, a calendar just for that month is 
printed. Year can be between 1 and 9999. The month is a number between | and 12. The calendar pro- 
duced is that for England and her colonies. 


Try September 1752. 


BUGS 
The year is always considered to start in January even though this is historically naive. 
Reware that ‘cal 78’ refers to the early Christian era, not the 20th century. 
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NAME 

calendar — reminder service 
SYNOPSIS 

calendar [ — ] 
DESCRIPTION 


Calendar consults the file ‘calendar’ in the current directory and prints out lines that contain today’s or 
tomorrow’s date anywhere in the line. Most reasonable month-day dates such as “Dec. 7,’ ‘december 7,’ 
‘12/7,’ etc., are recognized, but not “7 December’ or ‘7/12’. If you give the month as ‘**’’ with a date, i.e. 
““e 1°’, that day in any month will do. On weekends ‘tomorrow’ extends through Monday. 


When an argument is present, calendar does its job for every user who has a file ‘calendar’ in his login 
directory and sends him any positive results by mail(1). Normally this is done daily in the wee hours under 
control of cron(8). 


The file ‘calendar’ is first run through the ‘‘C’’ preprocessor, /lib/cpp, to include any other calendar files 
specified with the usual “‘#include’’ syntax. Included calendars will usually be shared by all users, main- 
tained and documented by the local administration. 


FILES 
calendar 
/usr/lib/calendar to figure out today’s and tomorrow’s dates 
/etc/passwd 
/tmp/cal* 
/lib/cpp, egrep, sed, mail as subprocesses 


SEE ALSO 
at(1), cron(8), mail(1) 


BUGS 
Calendar’s extended idea of ‘tomorrow’ doesn’t account for holidays. 
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NAME 
cat — catenate and print 


SYNOPSIS 
cat [—u ][-n][-s][-v] file... 
DESCRIPTION 
Cat reads each file in sequence and displays it on the standard output. Thus 
cat file 
displays the file on the standard output, and 
cat filel file2 >file3 
concatenates the first two files and places the result on the third. 


If no input file is given, or if the argument ‘—’ is encountered, cat reads from the standard input file. Output 
is buffered in the block size recommended by stat(2) unless the standard output is a terminal, when it is line 
buffered. The —u option makes the output completely unbuffered. 


The —n option displays the output lines preceded by lines numbers, numbered sequentially from 1. Specify- 
ing the -b option with the -n option omits the line numbers from blank lines. 


The —s option crushes out multiple adjacent empty lines so that the output is displayed single spaced. 


The —v option displays non-printing characters so that they are visible. Control characters print like *X for 
control-x; the delete character (octal 0177) prints as *?. Non-ascii characters (with the high bit set) are 
printed as M- (for meta) followed by the character of the low 7 bits. A -e option may be given with the —v 
option, which displays a ‘$’ character at the end of each line. Specifying the -t option with the —v option 
displays tab characters as “I. 


SEE ALSO 
cp(1), ex(1), more(1), pr(1), tail(1) 


BUGS 
Beware of ‘cat a b >a’ and ‘cat ab >b’, which destroy the input files before reading them. 
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NAME 
cb —C program beautifier 


SYNOPSIS 
cb 


DESCRIPTION 
Cb places a copy of the C program from the standard input on the standard output with spacing and indenta- 
tion that displays the structure of the program. 
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NAME 
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cc — C compiler 


SYNOPSIS 


ce [ option ] ... file... 


DESCRIPTION 


Cc is the UNIX C compiler. Cc accepts several types of arguments: 


Arguments whose names end with ‘.c’ are taken to be C source programs; they are compiled, and each 
object program is left on the file whose name is that of the source with ‘.o’ substituted for ‘.c’. The ‘.o’ file 
is normally deleted, however, if a single C program is compiled and loaded all at one go. 


In the same way, arguments whose names end with ‘.s’ are taken to be assembly source programs and are 
assembled, producing a ‘.o’ file. 


The following options are interpreted by cc. See /d(1) for load-time options. 


—c Suppress the loading phase of the compilation, and force an object file to be produced even if 
only one program is compiled. 

-g Have the compiler produce additional symbol table information for dbx(1). Also pass the Ig flag 
to Id(1). 

-go Have the compiler produce additional symbol table information for the obsolete debugger sdb(1). 
Also pass the -Ig flag to /d(1). 

-w Suppress warning diagnostics. 

-p Arrange for the compiler to produce code which counts the number of times each routine is 
called. If loading takes place, replace the standard startup routine by one which automatically 
calls monitor(3) at the start and arranges to write out a mon.out file at normal termination of exe- 
cution of the object program. An execution profile can then be generated by use of prof(1). 

—pg Causes the compiler to produce counting code in the manner of -p, but invokes a run-time 
recording mechanism that keeps more extensive statistics and produces a gmon.out file at normal 
termination. Also, a profiling library is searched, in lieu of the standard C library. An execution 
profile can then be generated by use of gprof(1). 

-O Invoke an object-code improver. 

-R Passed on to as, making initialized variables shared and read-only. 

-S Compile the named C programs, and leave the assembler-language output on corresponding files 
suffixed ‘.s’. 

—-M Run only the macro preprocessor on the named C programs, requesting it to generate Makefile 
dependencies and send the result to the standard output. 

-E Run only the macro preprocessor on the named C programs, and send the result to the standard 
output. 

-C prevent the macro preprocessor from eliding comments. 

—0 output 
Name the final output file output. If this option is used the file ‘a.out’ will be left undisturbed. 

—Dname=def 

-Dname Define the name to the preprocessor, as if by ‘#define’. If no definition is given, the name is 
defined as "1". 

-Uname Remove any initial definition of name. 

-Idir “#include’ files whose names do not begin with ‘/ are always sought first in the directory of the 


file argument, then in directories named in -I options, then in directories on a standard list. 
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FILES 


UNIX Programmer’s Manual CC(1) 


-Ldir Library archives are sought first in directories named in —-L options, then in directories on a stan- 
dard list. 


-f Use an alternate compiler which does not convert expressions involving only floats to double. 
This does not conform to the standard which states that all intermediate results should be con- 
verted to double but does provide a speed improvement for programs which don’t require full 
double precision. This option also makes register float variables work appropriately. 


-Bstring Find substitute compiler passes in the files named string with the suffixes cpp, ccom and c2. If 
string is empty, use a standard backup version. 


—t[p012 


a 


Find only the designated compiler passes in the files whose names are constructed by a -B 
option. In the absence of a —B option, the string is taken to be ‘/usr/c/’. 


Other arguments are taken to be either loader option arguments, or C-compatible object programs, typically 
produced by an earlier cc run, or perhaps libraries of C-compatible routines. These programs, together with 
the results of any compilations specified, are loaded (in the order given) to produce an executable program 
with name a.out. 


file.c input file 
file.o object file 
a.out loaded output 


/tmp/ctm? — temporary 

/ib/cpp preprocessor 

Nib/ecom compiler 

Nib/sccom compiler for single precision floats 
/usr/c/occom backup compiler 

/usr/c/ocpp _ backup preprocessor 

Nib/c2 optional optimizer 

Nib/crt0.o —_—- runtime startoff 

/ib/mert0O.o — startoff for profiling 
/usr/lib/gcrtO.ostartoff for gprof-profiling 

/lib/libe.a standard library, see intro(3) 
/usr/lib/libc_p.aprofiling library, see intro(3) 
/usr/include standard directory for ‘#include’ files 
mon.out file produced for analysis by prof(1) 
gmon.out file produced for analysis by gprof(1) 


SEE ALSO 


B. W. Kernighan and D. M. Ritchie, The C Programming Language, Prentice-Hall, 1978 
B. W. Kernighan, Programming in C—a tutorial 

D. M. Ritchie, C Reference Manual 

monitor(3), prof(1), gprof(1), adb(1), 1d(1), dbx(1), as(1) 


DIAGNOSTICS 


BUGS 


The diagnostics produced by C itself are intended to be self-explanatory. Occasional messages may be pro- 
duced by the assembler or loader. 


The compiler currently ignores advice to put char, unsigned char, short, unsigned short, float, or double 
variables in registers, except as noted above. It previously produced poor, and in some cases incorrect, 
code for such declarations. 
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NAME 
cd — change working directory 


SYNOPSIS 
cd directory 


DESCRIPTION 
Directory becomes the new working directory. The process must have execute (search) permission in 
directory. 


Because a new process is created to execute each command, cd would be ineffective if it were written as a 
normal command. It is therefore recognized and executed by the shells. In csh(1) you may specify a list of 
directories in which directory is to be sought as a subdirectory if it is not a subdirectory of the current direc- 
tory; see the description of the cdpath variable in csh(1). 


SEE ALSO 
csh(1), sh(1), pwd(1), chdir(2) 
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NAME 


checknr — check nroff/troff files 


SYNOPSIS 


checknr [ -s ] [ -f ] [ -a.xl.y1.x2.y2. ... .xn.yn ] [-e.x1.x2.x3 ... .xn] [file ... ] 


DESCRIPTION 


Checknr checks a list of nroff(1) or troff(1) input files for certain kinds of errors involving mismatched 
opening and closing delimiters and unknown commands. If no files are specified, checknr checks the stan- 
dard input. Delimeters checked are: 


(1) Font changes using \fx ... \fP. 
(2) Size changes using \sx ... \sO. 


(3) Macros that come in open ... close forms, for example, the .TS and .TE macros which must always 
come in pairs. 


Checknr knows about the ms(7) and me(7) macro packages. 


Additional pairs of macros can be added to the list using the —a option. This must be followed by groups of 
six characters, each group defining a pair of macros. The six characters are a period, the first macro name, 
another period, and the second macro name. For example, to define a pair .BS and .ES, use —a.BS.ES 


The —c option defines commands which would otherwise be complained about as undefined. 
The -f option requests checknr to ignore \f font changes. 
The —s option requests checknr to ignore \s size changes. 


Checknr is intended to be used on documents that are prepared with checknr in mind, much the same as 
lint. It expects a certain document writing style for \f and \s commands, in that each \fx must be terminated 
with \fP and each \sx must be terminated with \sO. While it will work to directly go into the next font or 
explicitly specify the original font or point size, and many existing documents actually do this, such a prac- 
tice will produce complaints from checknr. Since it is probably better to use the \fP and \sO forms anyway, 
you should think of this as a contribution to your document preparation style. 


SEE ALSO 


nroff(1), troff(1), checkeq(1), ms(7), me(7) 


DIAGNOSTICS 


BUGS 


Complaints about unmatched delimiters. 
Complaints about unrecognized commands. 
Various complaints about the syntax of commands. 


There is no way to define a 1 character macro name using —a. 
Does not correctly recognize certain reasonable constructs, such as conditionals. 
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NAME 

chgrp — change group 
SYNOPSIS 

chegrp [ -f -R ] group file ... 
DESCRIPTION 


Chgrp changes the group-ID of the files to group. The group may be either a decimal GID or a group name 
found in the group-ID file. 


The user invoking chgrp must belong to the specified group and be the owner of the file, or be the super- 
user. 


No errors are reported when the -f (force) option is given. 


When the -R option is given, chgrp recursively descends its directory arguments setting the specified 
group-ID. When symbolic links are encountered, their group is changed, but they are not traversed. 


FILES 
/etc/group 


SEE ALSO 
chown(2), passwd(5), group(5) 
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NAME 


chmod — change mode 


SYNOPSIS 


chmod [ -Rf ] mode file ... 


DESCRIPTION 


The mode of each named file is changed according to mode, which may be absolute or symbolic. An abso- 
lute mode is an octal number constructed from the OR of the following modes: 


4000 set user ID on execution 

2000 set group ID on execution 

1000 sticky bit, see chmod (2) 

0400 read by owner 

0200 write by owner 

0100 execute (search in directory) by owner 
0070 read, write, execute (search) by group 

0007 read, write, execute (search) by others 


A symbolic mode has the form: 
[who] op permission [op permission] ... 


The who part is a combination of the letters u (for user’s permissions), g (group) and o (other). The letter a 
stands for all, or ugo. If who is omitted, the default is a but the setting of the file creation mask (see 
umask(2)) is taken into account. 


Op can be + to add permission to the file’s mode, — to take away permission and = to assign permission 
absolutely (all other bits will be reset). 


Permission is any combination of the letters r (read), w (write), x (execute), X (set execute only if file is a 
directory or some other execute bit is set), s (set owner or group id) and t (save text — sticky). Letters u, g, 
or 0 indicate that permission is to be taken from the current mode. Omitting permission is only useful with 
= to take away all permissions. 


When the —R option is given, chmod recursively descends its directory arguments setting the mode for each 
file as described above. When symbolic links are encountered, their mode is not changed and they are not 
traversed. 


If the -f option is given, chmod will not complain if it fails to change the mode on a file. 


EXAMPLES 


The first example denies write permission to others, the second makes a file executable by all if it is exe- 
cutable by anyone: 


chmod o-—w file 
chmod +X file 


Multiple symbolic modes separated by commas may be given. Operations are performed in the order 
specified. The letter s is only useful with u or g. 


Only the owner of a file (or the super-user) may change its mode. 


SEE ALSO 


Is(1), chmod(2), stat(2), umask(2), chown(8) 
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NAME 
clear — clear terminal screen 


SYNOPSIS 
clear 


DESCRIPTION 
Clear clears your screen if this is possible. It looks in the environment for the terminal type and then in 
/etc/termcap to figure out how to clear the screen. 


FILES 
/etc/termcap terminal capability data base 
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NAME 
cmp — compare two files 


SYNOPSIS 
cmp [-1][-s ] file! file2 


DESCRIPTION 
The two files are compared. (If file/ is ‘—’, the standard input is used.) Under default options, cmp makes 
no comment if the files are the same; if they differ, it announces the byte and line number at which the dif- 
ference occurred. If one file is an initial subsequence of the other, that fact is noted. 


Options: 
-l Print the byte number (decimal) and the differing bytes (octal) for each difference. 
-s Print nothing for differing files; return codes only. 


SEE ALSO 
diff(1), comm(1) 


DIAGNOSTICS 
Exit code 0 is returned for identical files, 1 for different files, and 2 for an inaccessible or missing argument. 
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NAME 


col — filter reverse line feeds 


SYNOPSIS 


col [ —bfh ] 


DESCRIPTION 


Col reads the standard input and writes the standard output. It performs the line overlays implied by 
reverse line feeds (ESC-7 in ASCII) and by forward and reverse half line feeds (ESC-9 and ESC-8). Col is 
particularly useful for filtering multicolumn output made with the ‘.rt’? command of nroff and output result- 
ing from use of the tb/(1) preprocessor. 


Although col accepts half line motions in its input, it normally does not emit them on output. Instead, text 
that would appear between lines is moved to the next lower full line boundary. This treatment can be sup- 
pressed by the -f (fine) option; in this case the output from col may contain forward half line feeds (ESC- 
9), but will still never contain either kind of reverse line motion. 


If the —b option is given, col assumes that the output device in use is not capable of backspacing. In this 
case, if several characters are to appear in the same place, only the last one read will be taken. 


The control characters SO (ASCII code 017), and SI (016) are assumed to start and end text in an alternate 
character set. The character set (primary or alternate) associated with each printing character read is 
remembered; on output, SO and SI characters are generated where necessary to maintain the correct treat- 
ment of each character. 


If the -h option is given, col converts white space to tabs to shorten printing time. 


All control characters are removed from the input except space, backspace, tab, return, newline, ESC (033) 
followed by one of 7, 8, 9, SI, SO, and VT (013). This last character is an alternate form of full reverse line 
feed, for compatibility with some other hardware conventions. All other non-printing characters are 
ignored. 


SEE ALSO 


BUGS 


troff(1), tbl(1) 


Can’t back up more than 128 lines. 
No more than 800 characters, including backspaces, on a line. 
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NAME 


colcrt — filter nroff output for CRT previewing 


SYNOPSIS 


colert [—][-2][ file... ] 


DESCRIPTION 


Colcrt provides virtual half-line and reverse line feed sequences for terminals without such capability, and 
on which overstriking is destructive. Half-line characters and underlining (changed to dashing ‘—’) are 
placed on new lines in between the normal output lines. 


The optional — suppresses all underlining. It is especially useful for previewing allboxed tables from tb/(1). 


The option —2 causes all half-lines to be printed, effectively double spacing the output. Normally, a mini- 
mal space output format is used which will suppress empty lines. The program never suppresses two con- 
secutive empty lines, however. The —2 option is useful for sending output to the line printer when the out- 
put contains superscripts and subscripts which would otherwise be invisible. 


A typical use of colcrt would be 


tbl exum2.n | nroff —ms | colcrt — | more 


SEE ALSO 


BUGS 


nroff/troff(1), col(1), more(1), ul(1) 


Should fold underlines onto blanks even with the ‘—’ option so that a true underline character would show; 
if we did this, however, colcrt wouldn’t get rid of cu’d underlining completely. 


Can’t back up more than 102 lines. 
General overstriking is lost; as a special case * |’ overstruck with ‘~’ or underline becomes ‘+’. 
Lines are trimmed to 132 characters. 


Some provision should be made for processing superscripts and subscripts in documents which are already 
double-spaced. 
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NAME 
colrm — remove columns from a file 


SYNOPSIS 
colrm [ startcol [ endcol ] ] 


DESCRIPTION 
Colrm removes selected columns from a file. Input is taken from standard input. Output is sent to standard 


output. 


If called with one parameter the columns of each line will be removed starting with the specified column. If 
called with two parameters the columns from the first column to the last column will be removed. 


Column numbering starts with column 1. 


SEE ALSO 
expand(1) 
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NAME 

comm -— select or reject lines common to two sorted files 
SYNOPSIS 

comm [ — [ 123 ] ] file1 file2 
DESCRIPTION 


Comm reads fileI and file2, which should be ordered in ASCII collating sequence, and produces a three col- 
umn output: lines only in file/; lines only in file2; and lines in both files. The filename ‘—’ means the stan- 
dard input. 
Flags 1, 2, or 3 suppress printing of the corresponding column. Thus comm -12 prints only the lines com- 
mon to the two files; comm —23 prints only lines in the first file but not in the second; comm —123 is a no- 
op. 

SEE ALSO 
cmp(1), diff(1), uniq(1) 
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NAME 


compress, uncompress, zcat — compress and expand data 


SYNOPSIS 


compress [ -f ] [—v ] [-c ] [-b bits ] [ name... ] 
uncompress [ -f ] [—v ] [-c] [ name... ] 
zceat [ name ... | 


DESCRIPTION 


Compress reduces the size of the named files using adaptive Lempel-Ziv coding. Whenever possible, each 
file is replaced by one with the extension .Z, while keeping the same ownership modes, access and 
modification times. If no files are specified, the standard input is compressed to the standard output. Com- 
pressed files can be restored to their original form using uncompress or zcat. 


The -f option will force compression of name, even if it does not actually shrink or the corresponding 
name.Z file already exists. Except when run in the background under /bin/sh, if -f is not given the user is 
prompted as to whether an existing name .Z file should be overwritten. 


The —c (‘‘cat’’) option makes compress/uncompress write to the standard output; no files are changed. The 
nondestructive behavior of zcat is identical to that of uncompress —c. 


Compress uses the modified Lempel-Ziv algorithm popularized in "A Technique for High Performance 
Data Compression", Terry A. Welch, IEEE Computer, vol. 17, no. 6 (June 1984), pp. 8-19. Common sub- 
strings in the file are first replaced by 9-bit codes 257 and up. When code 512 is reached, the algorithm 
switches to 10-bit codes and continues to use more bits until the limit specified by the —b flag is reached 
(default 16). Bits must be between 9 and 16. The default can be changed in the source to allow compress 
to be run on a smaller machine. 


After the bits limit is attained, compress periodically checks the compression ratio. If it is increasing, com- 
press continues to use the existing code dictionary. However, if the compression ratio decreases, compress 
discards the table of substrings and rebuilds it from scratch. This allows the algorithm to adapt to the next 
"block" of the file. 


Note that the —b flag is omitted for uncompress, since the bits parameter specified during compression is 
encoded within the output, along with a magic number to ensure that neither decompression of random data 
nor recompression of compressed data is attempted. 


The amount of compression obtained depends on the size of the input, the number of bits per code, and the 
distribution of common substrings. Typically, text such as source code or English is reduced by 50-60%. 
Compression is generally much better than that achieved by Huffman coding (as used in pack), or adaptive 
Huffman coding (compact), and takes less time to compute. 


The —v option causes the printing of the percentage reduction of each file. 


If an error occurs, exit status is 1, else if the last file was not compressed because it became larger, the sta- 
tus is 2; else the status is 0. 


DIAGNOSTICS 


Usage: compress [—fvc] [—b maxbits] [file ...] 
Invalid options were specified on the command line. 
Missing maxbits 
Maxbits must follow —b. 
file: not in compressed format 
The file specified to uncompress has not been compressed. 
file: compressed with xx bits, can only handle yy bits 
File was compressed by a program that could deal with more bits than the compress 
code on this machine. Recompress the file with smaller bits. 
file: already has .Z suffix -- no change 
The file is assumed to be already compressed. Rename the file and try again. 
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file: filename too long to tack on .Z 
The file cannot be compressed because its name is longer than 12 characters. Rename 
and try again. This message does not occur on BSD systems. 
file already exists; do you wish to overwrite (y or n)? 
Respond "y" if you want the output file to be replaced; "n" if not. 
uncompress: corrupt input 
A SIGSEGV violation was detected which usually means that the input file is cor- 
rupted. 
Compression: xx.xx% 
Percentage of the input saved by compression. (Relevant only for —v.) 
-- not a regular file: unchanged 
When the input file is not a regular file, (e.g. a directory), it is left unaltered. 
-- has xx other links: unchanged 
The input file has links; it is left unchanged. See /n(1) for more information. 
-- file unchanged 


No savings is achieved by compression. The input remains virgin. 
BUGS 


Although compressed files are compatible between machines with large memory, —b12 should be used for 


file transfer to architectures with a small process data space (64KB or less, as exhibited by the DEC PDP 
series, the Inte] 80286, etc.) 


compress should be more flexible about the existence of the ‘.Z’ suffix. 


4.3 Berkeley Distribution May 11, 1986 2 


CP(1) UNIX Programmer’s Manual CP(1) 


NAME 
cp — copy 
SYNOPSIS 
cp [ -ip ] file1 file2 
cp [ -ipr ] file ... directory 


DESCRIPTION 
File] is copied onto file2. By default, the mode and owner of file2 are preserved if it already existed; other- 
wise the mode of the source file modified by the current umask(2) is used. The —p option causes cp to 
attempt to preserve (duplicate) in its copies the modification times and modes of the source files, ignoring 
the present umask. 


In the second form, one or more files are copied into the directory with their original file-names. 
Cp refuses to copy a file onto itself. 


If the -i option is specified, cp will prompt the user with the name of the file whenever the copy will cause 
an old file to be overwritten. An answer of ’y’ will cause cp to continue. Any other answer will prevent it 
from overwriting the file. 


If the -r option is specified and any of the source files are directories, cp copies each subtree rooted at that 
name; in this case the destination must be a directory. 


SEE ALSO 
cat(1), mv(1), rep(1C) 
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NAME 
crypt — encode/decode 


SYNOPSIS 
crypt [ password ] 


DESCRIPTION 
Crypt reads from the standard input and writes on the standard output. The password is a key that selects a 
particular transformation. If no password is given, crypt demands a key from the terminal and turns off 
printing while the key is being typed in. Crypt encrypts and decrypts with the same key: 


crypt key <clear >cypher 
crypt key <cypher | pr 


will print the clear. 
Files encrypted by crypt are compatible with those treated by the editor ed in encryption mode. 


The security of encrypted files depends on three factors: the fundamental method must be hard to solve; 
direct search of the key space must be infeasible; ‘sneak paths’ by which keys or cleartext can become visi- 
ble must be minimized. 


Crypt implements a one-rotor machine designed along the lines of the German Enigma, but with a 256- 
element rotor. Methods of attack on such machines are known, but not widely; moreover the amount of 
work required is likely to be large. 


The transformation of a key into the internal settings of the machine is deliberately designed to be expen- 
Sive, i.e. to take a substantial fraction of a second to compute. However, if keys are restricted to (say) three 
lower-case letters, then encrypted files can be read by expending only a substantial fraction of five minutes 
of machine time. 


Since the key is an argument to the crypt command, it is potentially visible to users executing ps(1) or a 
derivative. To minimize this possibility, crypt takes care to destroy any record of the key immediately upon 
entry. No doubt the choice of keys and key security are the most vulnerable aspect of crypt. 


FILES 

/dev/tty for typed key 
SEE ALSO 

ed(1), makekey(8) 
BUGS 


There is no warranty of merchantability nor any warranty of fitness for a particular purpose nor any other 
warranty, either express or implied, as to the accuracy of the enclosed materials or as to their suitability for 
any particular purpose. Accordingly, Bell Telephone Laboratories assumes no responsibility for their use 
by the recipient. Further, Bell Laboratories assumes no obligation to furnish any assistance of any kind 
whatsoever, or to furnish any additional information or documentation. 
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NAME 

csh — a shell (command interpreter) with C-like syntax 
SYNOPSIS 

csh [ -cefinstvVxX ] [ arg... ] 
DESCRIPTION 


Csh is a first implementation of a command language interpreter incorporating a history mechanism (see 
History Substitutions), job control facilities (see Jobs), interactive file name and user name completion 
(see File Name Completion), and a C-like syntax. So as to be able to use its job control facilities, users of 
csh must (and automatically) use the new tty driver fully described in tty(4). This new tty driver allows 
generation of interrupt characters from the keyboard to tell jobs to stop. See stty(1) for details on setting 
options in the new tty driver. 


An instance of csh begins by executing commands from the file ‘.cshrc’ in the home directory of the 
invoker. If this is a login shell then it also executes commands from the file ‘login’ there. It is typical for 
users on crt’s to put the command “‘stty crt’’ in their ./ogin file, and to also invoke fsef(1) there. 


In the normal case, the shell will then begin reading commands from the terminal, prompting with ‘% ’. 
Processing of arguments and the use of the shell to process files containing command scripts will be 
described later. 


The shell then repeatedly performs the following actions: a line of command input is read and broken into 
words. This sequence of words is placed on the command history list and then parsed. Finally each com- 
mand in the current line is executed. 


When a login shell terminates it executes commands from the file ‘.logout’ in the users home directory. 
Lexical structure 


The shell splits input lines into words at blanks and tabs with the following exceptions. The characters *&’ 
‘|? S° «<7 >" “7 5? form separate words. If doubled in ‘&&’, ‘| |’, ‘<<’ or ‘>>’ these pairs form single 
words. These parser metacharacters may be made part of other words, or prevented their special meaning, 
by preceding them with ‘\’. A newline preceded by a ‘\’ is equivalent to a blank. 


679° GND 


In addition strings enclosed in matched pairs of quotations, ‘”’, “’ or ‘"’, form parts of a word; metacharac- 
ters in these strings, including blanks and tabs, do not form separate words. These quotations have seman- 
tics to be described subsequently. Within pairs of ‘” or ‘"’ characters a newline preceded by a ‘\’ gives a 
true newline character. 

When the shell’s input is not a terminal, the character ‘#’ introduces a comment which continues to the end 
of the input line. It is prevented this special meaning when preceded by ‘\’ and in quotations using *’, ‘”’, 
and ‘"’. 


Commands 


A simple command is a sequence of words, the first of which specifies the command to be executed. A 
simple command or a sequence of simple commands separated by ‘ |’ characters forms a pipeline. The out- 
put of each command in a pipeline is connected to the input of the next. Sequences of pipelines may be 


separated by ‘;’, and are then executed sequentially. A sequence of pipelines may be executed without 
immediately waiting for it to terminate by following it with an ‘&’. 


Any of the above may be placed in ‘(’ ‘)’ to form a simple command (which may be a component of a pipe- 
line, etc.) It is also possible to separate pipelines with ‘| |? or ‘&&’ indicating, as in the C language, that 
the second is to be executed only if the first fails or succeeds respectively. (See Expressions.) 
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Jobs 


The shell associates a job with each pipeline. It keeps a table of current jobs, printed by the jobs command, 
and assigns them small integer numbers. When a job is started asynchronously with ‘&’, the shell prints a 
line which looks like: 


[1] 1234 


indicating that the job which was started asynchronously was job number | and had one (top-level) process, 
whose process id was 1234. 


If you are running a job and wish to do something else you may hit the key *Z (control-Z) which sends a 
STOP signal to the current job. The shell will then normally indicate that the job has been ‘Stopped’, and 
print another prompt. You can then manipulate the state of this job, putting it in the background with the 
bg command, or run some other commands and then eventually bring the job back into the foreground with 
the foreground command fg. A *Z takes effect immediately and is like an interrupt in that pending output 
and unread input are discarded when it is typed. There is another special key ~*Y which does not generate a 
STOP signal until a program attempts to read(2) it. This can usefully be typed ahead when you have pre- 
pared some commands for a job which you wish to stop after it has read them. 


A job being run in the background will stop if it tries to read from the terminal. Background jobs are nor- 
mally allowed to produce output, but this can be disabled by giving the command ‘“‘stty tostop’’. If you set 
this tty option, then background jobs will stop when they try to produce output like they do when they try to 
read input. 


There are several ways to refer to jobs in the shell. The character ‘%’ introduces a job name. If you wish to 
refer to job number 1, you can name it as ‘%1’. Just naming a job brings it to the foreground; thus *%1’ is 
a synonym for ‘fg %1’, bringing job | back into the foreground. Similarly saying ‘%1 &’ resumes job | in 
the background. Jobs can also be named by prefixes of the string typed in to start them, if these prefixes are 
unambiguous, thus ‘%ex’ would normally restart a suspended ex(1) job, if there were only one suspended 
job whose name began with the string ‘ex’. It is also possible to say “%?string’ which specifies a job whose 
text contains string, if there is only one such job. 


The shell maintains a notion of the current and previous jobs. In output pertaining to jobs, the current job is 
marked with a ‘+’ and the previous job with a ‘“—’. The abbreviation *%-+’ refers to the current job and *%—-’ 
refers to the previous job. For close analogy with the syntax of the history mechanism (described below), 
‘%%’ is also a synonym for the current job. 


Status reporting 


This shell learns immediately whenever a process changes state. It normally informs you whenever a job 
becomes blocked so that no further progress is possible, but only just before it prints a prompt. This is done 
so that it does not otherwise disturb your work. If, however, you set the shell variable notify, the shell will 
notify you immediately of changes of status in background jobs. There is also a shell command notify 
which marks a single process so that its status changes will be immediately reported. By default notify 
marks the current process; simply say ‘notify’ after starting a background job to mark it. 


When you try to leave the shell while jobs are stopped, you will be warned that ‘You have stopped jobs.’ 
You may use the jobs command to see what they are. If you do this or immediately try to exit again, the 
shell will not warn you a second time, and the suspended jobs will be terminated. 


File Name Completion 


When the file name completion feature is enabled by setting the shell variable filec (see set), csh will inter- 
actively complete file names and user names from unique prefixes, when they are input from the terminal 
followed by the escape character (the escape key, or control-[). For example, if the current directory looks 


like 
DSC.OLD bin cmd lib xmpl.c 
DSC.NEW chaosnet cmtest mail xmpl.o 
bench class dev mbox xmpl.out 
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and the input is 
% vi ch<escape> 
csh will complete the prefix ‘‘ch’’ to the only matching file name “‘chaosnet’’, changing the input line to 
% vi chaosnet 
However, given 
% vi D<escape> 
csh will only expand the input to 
% vi DSC. 
and will sound the terminal bell to indicate that the expansion is incomplete, since there are two file names 
matching the prefix ‘‘D’’. 


If a partial file name is followed by the end-of-file character (usually control-D), then, instead of completing 
the name, csh will list all file names matching the prefix. For example, the input 
% vi D<control-D> 
causes all files beginning with ‘‘D’’ to be listed: 
DSC.NEW DSC.OLD 
while the input line remains unchanged. 


The same system of escape and end-of-file can also be used to expand partial user names, if the word to be 
completed (or listed) begins with the character ““’’. For example, typing 

cd “ro<control-D> 
may produce the expansion 

cd “root 


The use of the terminal bell to signal errors or multiple matches can be inhibited by setting the variable 
nobeep. 


Normally, all files in the particular directory are candidates for name completion. Files with certain 
suffixes can be excluded from consideration by setting the variable fignore to the list of suffixes to be 
ignored. Thus, if fignore is set by the command 

% set fignore = (.0 .out) 
then typing 

% Vi X<escape> 
would result in the completion to 

% vi xmpl.c 
ignoring the files "xmpl.o" and "xmpl.out". However, if the only completion possible requires not ignoring 
these suffixes, then they are not ignored. In addition, fignore does not affect the listing of file names by 
control-D. All files are listed regardless of their suffixes. 


Substitutions 


We now describe the various transformations the shell performs on the input in the order in which they 
occur. 


History substitutions 


History substitutions place words from previous command input as portions of new commands, making it 
easy to repeat commands, repeat arguments of a previous command in the current command, or fix spelling 
mistakes in the previous command with little typing and a high degree of confidence. History substitutions 
begin with the character ‘!’ and may begin anywhere in the input stream (with the proviso that they do not 
nest.) This ‘!’ may be preceded by an ‘\’ to prevent its special meaning; for convenience, a ‘!’ is passed 
unchanged when it is followed by a blank, tab, newline, ‘=’ or ‘(. (History substitutions also occur when 
an input line begins with ‘T. This special abbreviation will be described later.) Any input line which con- 
tains history substitution is echoed on the terminal before it is executed as it could have been typed without 
history substitution. 
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Commands input from the terminal which consist of one or more words are saved on the history list. The 
history substitutions reintroduce sequences of words from these saved commands into the input stream. 
The size of which is controlled by the history variable; the previous command is always retained, regardless 
of its value. Commands are numbered sequentially from 1. 


For definiteness, consider the following output from the history command: 


9 write michael 
10 ex write.c 

11 cat oldwrite.c 
12 diff *write.c 


The commands are shown with their event numbers. It is not usually necessary to use event numbers, but 
the current event number can be made part of the prompt by placing an ‘!’ in the prompt string. 


With the current event 13 we can refer to previous events by event number ‘!11’, relatively as in ‘!—2’ 
(referring to the same event), by a prefix of a command word as in ‘!d’ for event 12 or ‘!wri’ for event 9, or 
by a string contained in a word in the command as in ‘!?mic?’ also referring to event 9. These forms, with- 
out further modification, simply reintroduce the words of the specified events, each separated by a single 
blank. As a special case ‘!!’ refers to the previous command; thus ‘!!’ alone is essentially a redo. 


To select words from an event we can follow the event specification by a ‘:’ and a designator for the desired 
words. The words of an input line are numbered from 0, the first (usually command) word being 0, the sec- 
ond word (first argument) being 1, etc. The basic word designators are: 


0 first (command) word 

n n’th argument 

T first argument, i.e. ‘1’ 

$ last argument 

% word matched by (immediately preceding) ?s? search 

x-y range of words 

-y abbreviates ‘O-y’ 

* abbreviates ‘T-$’, or nothing if only 1 word in event 

x* abbreviates ‘x —$’ 

x= like ‘x *’ but omitting word ‘$’ 
The ‘:’ separating the event specification from the word designator can be omitted if the argument selector 
begins with a ‘Tr, «$e or *%’. After the optional word designator can be placed a sequence of 
modifiers, each preceded by a ‘:’. The following modifiers are defined: 

h Remove a trailing pathname component, leaving the head. 

rt Remove a trailing ‘.xxx’ component, leaving the root name. 

e Remove all but the extension ‘.xxx’ part. 

s/l/r/ Substitute / for r 


t Remove all leading pathname components, leaving the tail. 
& Repeat the previous substitution. 

g Apply the change globally, prefixing the above, e.g. ‘g&’. 

p Print the new command but do not execute it. 

q Quote the substituted words, preventing further substitutions. 
x Like q, but break into words at blanks, tabs and newlines. 


Unless preceded by a ‘g’ the modification is applied only to the first modifiable word. With substitutions, it 
is an error for no word to be applicable. 


The left hand side of substitutions are not regular expressions in the sense of the editors, but rather strings. 
Any character may be used as the delimiter in place of ‘/’; a “V quotes the delimiter into the / and r strings. 
The character ‘&’ in the right hand side is replaced by the text from the left. A ‘V quotes ‘&’ also. A null / 
uses the previous string either from a / or from a contextual scan string s in ‘!?s?’. The trailing delimiter in 
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? 


the substitution may be omitted if a newline follows immediately as may the trailing ‘?’ in a contextual 


scan. 


A history reference may be given without an event specification, e.g. ‘!$’. In this case the reference is to 
the previous command unless a previous history reference occurred on the same line in which case this 
form repeats the previous reference. Thus ‘!9f00?T 1$° gives the first and last arguments from the com- 
mand matching ‘?foo?’. 


A special abbreviation of a history reference occurs when the first non-blank character of an input line is a 
‘T. This is equivalent to ‘I:sT? providing a convenient shorthand for substitutions on the text of the previ- 
ous line. Thus ‘TIbTlib’ fixes the spelling of ‘lib’ in the previous command. Finally, a history substitution 
may be surrounded with ‘{’ and ‘}’ if necessary to insulate it from the characters which follow. Thus, after 
‘Is -Id “paul’ we might do ‘!{l}a’ to do ‘Is -Id ~paula’, while ‘!la’ would look for a command starting ‘la’. 


Quotations with “ and " 


> 


The quotation of strings by ‘* 
Strings enclosed in ‘” are prevented any further interpretation. Strings enclosed in 
described below. 


and ‘"’ can be used to prevent all or some of the remaining substitutions. 
“"’ may be expanded as 


In both cases the resulting text becomes (all or part of) a single word; only in one special case (see Com- 
mand Substitition below) does a ‘"’ quoted string yield parts of more than one word; quoted strings 
never do. 


679 


Alias substitution 


The shell maintains a list of aliases which can be established, displayed and modified by the alias and una- 
lias commands. After a command line is scanned, it is parsed into distinct commands and the first word of 
each command, left-to-right, is checked to see if it has an alias. If it does, then the text which is the alias 
for that command is reread with the history mechanism available as though that command were the previ- 
ous input line. The resulting words replace the command and argument list. If no reference is made to the 
history list, then the argument list is left unchanged. 


Thus if the alias for ‘Is’ is ‘ls -l’ the command ‘ls /usr’? would map to ‘Is —1 /usr’, the argument list here 
being undisturbed. Similarly if the alias for ‘lookup’ was ‘grep IT /etc/passwd’ then ‘lookup bill’ would 
map to ‘grep bill /etc/passwd’. 


If an alias is found, the word transformation of the input text is performed and the aliasing process begins 
again on the reformed input line. Looping is prevented if the first word of the new text is the same as the 
old by flagging it to prevent further aliasing. Other loops are detected and cause an error. 


Note that the mechanism allows aliases to introduce parser metasyntax. Thus we can ‘alias print “pr \!* | 
Ipr” to make a command which pr’s its arguments to the line printer. 


Variable substitution 


The shell maintains a set of variables, each of which has as value a list of zero or more words. Some of 
these variables are set by the shell or referred to by it. For instance, the argv variable is an image of the 
shell’s argument list, and words of this variable’s value are referred to in special ways. 


The values of variables may be displayed and changed by using the set and unset commands. Of the vari- 
ables referred to by the shell a number are toggles; the shell does not care what their value is, only whether 
they are set or not. For instance, the verbose variable is a toggle which causes command input to be 
echoed. The setting of this variable results from the -v command line option. 


Other operations treat variables numerically. The “@’ command permits numeric calculations to be per- 
formed and the result assigned to a variable. Variable values are, however, always represented as (zero or 
more) strings. For the purposes of numeric operations, the null string is considered to be zero, and the sec- 
ond and subsequent words of multiword values are ignored. 
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After the input line is aliased and parsed, and before each command is executed, variable substitution is 
performed keyed by ‘$’ characters. This expansion can be prevented by preceding the ‘$’ with a ‘V except 
within ‘"’s where it always occurs, and within “”s where it never occurs. Strings quoted by “’ are inter- 
preted later (see Command substitution below) so ‘$’ substitution does not occur there until later, if at all. 
A ‘$’ is passed unchanged if followed by a blank, tab, or end-of-line. 


679 “no 


Input/output redirections are recognized before variable expansion, and are variable expanded separately. 
Otherwise, the command name and entire argument list are expanded together. It is thus possible for the 
first (command) word to this point to generate more than one word, the first of which becomes the com- 
mand name, and the rest of which become arguments. 


om 


Unless enclosed in “"’ or given the ‘:q’ modifier the results of variable substitution may eventually be com- 
mand and filename substituted. Within ‘"’, a variable whose value consists of multiple words expands to a 
(portion of) a single word, with the words of the variables value separated by blanks. When the ‘:q’ 
modifier is applied to a substitution the variable will expand to multiple words with each word separated by 
a blank and quoted to prevent later command or filename substitution. 


The following metasequences are provided for introducing variable values into the shell input. Except as 
noted, it is an error to reference a variable which is not set. 


$name 

${name } 
Are replaced by the words of the value of variable name, each separated by a blank. Braces insulate 
name from following characters which would otherwise be part of it. Shell variables have names 
consisting of up to 20 letters and digits starting with a letter. The underscore character is considered 
a letter. 
If name is not a shell variable, but is set in the environment, then that value is returned (but : 
modifiers and the other forms given below are not available in this case). 


$name[selector] 

${name[selector] } 
May be used to select only some of the words from the value of name. The selector is subjected to ‘$’ 
substitution and may consist of a single number or two numbers separated by a ‘—’. The first word of 
a variables value is numbered ‘1’. If the first number of a range is omitted it defaults to ‘1’. If the 
last member of a range is omitted it defaults to ‘$#name’. The selector ‘*’ selects all words. It is not 
an error for a range to be empty if the second argument is omitted or in range. 


$#name 
${#name } 
Gives the number of words in the variable. This is useful for later use in a ‘[selector]’. 
$0 
Substitutes the name of the file from which command input is being read. An error occurs if the 
name is not known. 
$number 
${number} 
Equivalent to ‘$argv[number]’. 
$x 


Equivalent to ‘$argv[*]’. 


The modifiers ‘th’, ‘:t’, “:1’, ‘:q’ and ‘:x’ may be applied to the substitutions above as may ‘:gh’, ‘:gt’ and 
‘:gr’. If braces *{’ ’}’ appear in the command form then the modifiers must appear within the braces. The 
current implementation allows only one ‘:’ modifier on each ‘$’ expansion. 


The following substitutions may not be modified with ‘:’ modifiers. 
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$?name 
${?name} 
Substitutes the string ‘1’ if name is set, ‘O’ if it is not. 


$20 
Substitutes ‘1’ if the current input filename is known, ‘0’ if it is not. 


$$ 


Substitute the (decimal) process number of the (parent) shell. 


$< 
Substitutes a line from the standard input, with no further interpretation thereafter. It can be used to 
read from the keyboard in a shell script. 


Command and filename substitution 


The remaining substitutions, command and filename substitution, are applied selectively to the arguments 
of builtin commands. This means that portions of expressions which are not evaluated are not subjected to 
these expansions. For commands which are not internal to the shell, the command name is substituted sep- 
arately from the argument list. This occurs very late, after input-output redirection is performed, and in a 
child of the main shell. 


Command substitution 


Command substitution is indicated by a command enclosed in *’. The output from such a command is nor- 
mally broken into separate words at blanks, tabs and newlines, with null words being discarded, this text 
then replacing the original string. Within ‘"’s, only newlines force new words; blanks and tabs are pre- 
served. 


In any case, the single final newline does not force a new word. Note that it is thus possible for a command 
substitution to yield only part of a word, even if the command outputs a complete line. 


Filename substitution 


“~ 


If a word contains any of the characters ‘*’, ‘?’, ‘[’ or ‘{’ or begins with the character ‘’, then that word is a 
candidate for filename substitution, also known as ‘globbing’. This word is then regarded as a pattern, and 
replaced with an alphabetically sorted list of file names which match the pattern. In a list of words specify- 
ing filename substitution it is an error for no pattern to match an existing file name, but it is not required for 
each pattern to match. Only the metacharacters ‘*’, ‘?’ and ‘[’ imply pattern matching, the characters “~”’ 
and ‘{’ being more akin to abbreviations. 


r) 


In matching filenames, the character ‘.’ at the beginning of a filename or immediately following a ‘/’, as 
well as the character ‘/’ must be matched explicitly. The character ‘*’ matches any string of characters, 
including the null string. The character “?’ matches any single character. The sequence ‘[...]’ matches any 
one of the characters enclosed. Within ‘[...]’, a pair of characters separated by “—’ matches any character 
lexically between the two. 


> 


The character “’ at the beginning of a filename is used to refer to home directories. Standing alone, i.e. ~ 
it expands to the invokers home directory as reflected in the value of the variable home. When followed by 
a name consisting of letters, digits and ‘—’ characters the shell searches for a user with that name and substi- 
tutes their home directory; thus “ken’ might expand to ‘/usr/ken’ and ‘“ken/chmach’ to ‘/usr/ken/chmach’. 
If the character ‘~’ is followed by a character other than a letter or ‘/ or appears not at the beginning of a 
word, it is left undisturbed. 


The metanotation ‘a{b,c,d}e’ is a shorthand for ‘abe ace ade’. Left to right order is preserved, with results 
of matches being sorted separately at a low level to preserve this order. This construct may be nested. 
Thus “source/s1/{oldls,ls}.c’ expands to ‘/usr/source/s 1/oldls.c /usr/source/s1/ls.c’ whether or not these 
files exist without any chance of error if the home directory for ‘source’ is ‘/usr/source’. Similarly 
“../{memo,*box}’ might expand to *../memo ../box ../mbox’. (Note that ‘memo’ was not sorted with the 
results of matching ‘*box’.) As a special case ‘{’, ‘}’ and ‘{}’ are passed undisturbed. 
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Input/output 
The standard input and standard output of a command may be redirected with the following syntax: 


< name 
Open file name (which is first variable, command and filename expanded) as the standard input. 


<< word 

Read the shell input up to a line which is identical to word. Word is not subjected to variable, 
filename or command substitution, and each input line is compared to word before any substitutions 
are done on this input line. Unless a quoting ‘\’, ‘"’, ‘” or “’ appears in word variable and command 
substitution is performed on the intervening lines, allowing ‘\ to quote ‘$’, ‘V and “’. Commands 
which are substituted have all blanks, tabs, and newlines preserved, except for the final newline 
which is dropped. The resultant text is placed in an anonymous temporary file which is given to the 
command as standard input. 


> name 

>! name 

>& name 

>&! name 
The file name is used as standard output. If the file does not exist then it is created; if the file exists, 
its is truncated, its previous contents being lost. 


If the variable noclobber is set, then the file must not exist or be a character special file (e.g. a termi- 
nal or ‘/dev/null’) or an error results. This helps prevent accidental destruction of files. In this case 
the ‘!’ forms can be used and suppress this check. 


The forms involving ‘&’ route the diagnostic output into the specified file as well as the standard out- 
put. Name is expanded in the same way as ‘<’ input filenames are. 


>> name 
>>& name 
>>! name 
>>&! name 
Uses file name as standard output like ‘>’ but places output at the end of the file. If the variable 
noclobber is set, then it is an error for the file not to exist unless one of the ‘!’ forms is given. Other- 
wise similar to ‘>’. 
A command receives the environment in which the shell was invoked as modified by the input-output 
parameters and the presence of the command in a pipeline. Thus, unlike some previous shells, commands 
run from a file of shell commands have no access to the text of the commands by default; rather they 
receive the original standard input of the shell. The ‘<<’ mechanism should be used to present inline data. 
This permits shell command scripts to function as components of pipelines and allows the shell to block 
read its input. Note that the default standard input for a command run detached is not modified to be the 
empty file ‘/dev/null’; rather the standard input remains as the original standard input of the shell. If this is 
a terminal and if the process attempts to read from the terminal, then the process will block and the user 
will be notified (see Jobs above). 


Diagnostic output may be directed through a pipe with the standard output. Simply use the form ‘| & 
rather than just * hee 


Expressions 


A number of the builtin commands (to be described subsequently) take expressions, in which the operators 
are similar to those of C, with the same precedence. These expressions appear in the @, exit, if, and while 
commands. The following operators are available: 


|| && | PT & se lee Pere coca + */%17() 
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Here the precedence increases to the right, ‘==’ ‘!=’ ‘= and ‘!”’, ‘<=’ ‘>=’ ‘<’ and ‘>’, ‘<<’ and ‘>>’, ‘+’ 
and ‘—’, ‘*’ ‘? and ‘%’ being, in groups, at the same level. The ‘==’ ‘!=’ ‘=~ and ‘!” operators compare 
their arguments as strings; all others operate on numbers. The operators ‘=~ and ‘!”’ are like ‘!=’ and ‘==’ 


except that the right hand side is a pattern (containing, e.g. ‘*’s, ‘?’s and instances of ‘[...]’) against which 
the left hand operand is matched. This reduces the need for use of the switch statement in shell scripts 
when all that is really needed is pattern matching. 


Strings which begin with ‘0’ are considered octal numbers. Null or missing arguments are considered ‘0’. 
The result of all expressions are strings, which represent decimal numbers. It is important to note that no 
two components of an expression can appear in the same word; except when adjacent to components of 
expressions which are syntactically significant to the parser (‘&’ 5 luli Saks Me they should be sur- 
rounded by spaces. 


Also available in expressions as primitive operands are command executions enclosed in ‘{’ and ‘}’ and file 
enquiries of the form ‘—/ name’ where / is one of: 


read access 
write access 
execute access 
existence 
ownership 
Zero Size 
plain file 
directory 


a mnNOTKX <= 7 


The specified name is command and filename expanded and then tested to see if it has the specified rela- 
tionship to the real user. If the file does not exist or is inaccessible then all enquiries return false, i.e. ‘0’. 
Command executions succeed, returning true, i.e. ‘1’, if the command exits with status 0, otherwise they 
fail, returning false, i.e. ‘0’. If more detailed status information is required then the command should be 
executed outside of an expression and the variable status examined. 


Control flow 


The shell contains a number of commands which can be used to regulate the flow of control in command 
files (shell scripts) and (in limited but useful ways) from terminal input. These commands all operate by 
forcing the shell to reread or skip in its input and, due to the implementation, restrict the placement of some 
of the commands. 


The foreach, switch, and while statements, as well as the if-then-else form of the if statement require that 
the major keywords appear in a single simple command on an input line as shown below. 


If the shell’s input is not seekable, the shell buffers up input whenever a loop is being read and performs 
seeks in this internal buffer to accomplish the rereading implied by the loop. (To the extent that this allows, 
backward goto’s will succeed on non-seekable inputs.) 


Builtin commands 


Builtin commands are executed within the shell. If a builtin command occurs as any component of a pipe- 
line except the last then it is executed in a subshell. 


alias 

alias name 

alias name wordlist 
The first form prints all aliases. The second form prints the alias for name. The final form assigns 
the specified wordlist as the alias of name; wordlist is command and filename substituted. Name is 
not allowed to be alias or unalias. 


alloc 
Shows the amount of dynamic memory acquired, broken down into used and free memory. With an 
argument shows the number of free and used blocks in each size category. The categories start at size 
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8 and double at each step. This command’s output may vary across system types, since systems other 
than the VAX may use a different memory allocator. 


bg 

bg %job ... 
Puts the current or specified jobs into the background, continuing them if they were stopped. 

break 
Causes execution to resume after the end of the nearest enclosing foreach or while. The remaining 
commands on the current line are executed. Multi-level breaks are thus possible by writing them all 
on one line. 

breaksw 
Causes a break from a switch, resuming after the endsw. 

case label: 
A label in a switch statement as discussed below. 

cd 

cd name 

chdir 


chdir name 
Change the shell’s working directory to directory name. If no argument is given then change to the 
home directory of the user. 
If name is not found as a subdirectory of the current directory (and does not begin with ‘/’, ‘/’ or 
“./’), then each component of the variable cdpath is checked to see if it has a subdirectory name. 
Finally, if all else fails but name is a shell variable whose value begins with ‘/’, then this is tried to 
see if it is a directory. 


continue 
Continue execution of the nearest enclosing while or foreach. The rest of the commands on the cur- 
rent line are executed. 


default: 
Labels the default case in a switch statement. The default should come after all case labels. 

dirs 
Prints the directory stack; the top of the stack is at the left, the first directory in the stack being the 
current directory. 


echo wordlist 

echo —n wordlist 
The specified words are written to the shells standard output, separated by spaces, and terminated 
with a newline unless the —n option is specified. 


else 
end 
endif 
endsw 
See the description of the foreach, if} switch, and while statements below. 


eval arg ... 
(As in sh(1).) The arguments are read as input to the shell and the resulting command(s) executed in 
the context of the current shell. This is usually used to execute commands generated as the result of 
command or variable substitution, since parsing occurs before these substitutions. See tsef(1) for an 
example of using eval. 


exec command 
The specified command is executed in place of the current shell. 
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exit 

exit(expr) 
The shell exits either with the value of the status variable (first form) or with the value of the 
specified expr (second form). 


fg 
fg %job... 
Brings the current or specified jobs into the foreground, continuing them if they were stopped. 


foreach name (wordlist) 


end 
The variable name is successively set to each member of wordlist and the sequence of commands 
between this command and the matching end are executed. (Both foreach and end must appear alone 
on separate lines.) 


The builtin command continue may be used to continue the loop prematurely and the builtin com- 
mand break to terminate it prematurely. When this command is read from the terminal, the loop is 
read up once prompting with ‘?’ before any statements in the loop are executed. If you make a mis- 
take typing in a loop at the terminal you can rub it out. 


glob wordlist 
Like echo but no ‘\’ escapes are recognized and words are delimited by null characters in the output. 
Useful for programs which wish to use the shell to filename expand a list of words. 


goto word 
The specified word is filename and command expanded to yield a string of the form ‘label’. The 
shell rewinds its input as much as possible and searches for a line of the form ‘label:’ possibly pre- 
ceded by blanks or tabs. Execution continues after the specified line. 


hashstat 
Print a statistics line indicating how effective the internal hash table has been at locating commands 
(and avoiding exec’s). An exec is attempted for each component of the path where the hash function 
indicates a possible hit, and in each component which does not begin with a ‘/’. 


history 

history n 

history -rn 

history —hn 
Displays the history event list; if m is given only the n most recent events are printed. The -r option 
reverses the order of printout to be most recent first rather than oldest first. The —h option causes the 
history list to be printed without leading numbers. This is used to produce files suitable for sourceing 
using the —h option to source. 

if (expr) command 
If the specified expression evaluates true, then the single command with arguments is executed. Vari- 
able substitution on command happens early, at the same time it does for the rest of the if command. 
Command must be a simple command, not a pipeline, a command list, or a parenthesized command 


list. Input/output redirection occurs even if expr is false, when command is not executed (this is a 
bug). 


if (expr) then 
else if (expr2) then 


else 
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endif 
If the specified expr is true then the commands to the first else are executed; otherwise if expr2 is true 
then the commands to the second else are executed, etc. Any number of else-if pairs are possible; 
only one endif is needed. The else part is likewise optional. (The words else and endif must appear 
at the beginning of input lines; the if must appear alone on its input line or after an else.) 


jobs 
jobs -1 
Lists the active jobs; given the -l options lists process id’s in addition to the normal information. 


kill %job 

kill -sig %job ... 

kill pid 

kill -sig pid ... 

kill -1 
Sends either the TERM (terminate) signal or the specified signal to the specified jobs or processes. 
Signals are either given by number or by names (as given in /usr/include/signal.h, stripped of the 
prefix ‘‘SIG’’). The signal names are listed by ‘kill -I’’. There is no default, saying just ‘kill’ does 
not send a signal to the current job. If the signal being sent is TERM (terminate) or HUP (hangup), 
then the job or process will be sent a CONT (continue) signal as well. 

limit 

limit resource 

limit resource maximum-use 

limit —h 

limit —h resource 

limit —h resource maximum-use 
Limits the consumption by the current process and each process it creates to not individually exceed 
maximum-use on the specified resource. If no maximum-use is given, then the current limit is 
printed; if no resource is given, then all limitations are given. If the —-h flag is given, the hard limits 
are used instead of the current limits. The hard limits impose a ceiling on the values of the current 
limits. Only the super-user may raise the hard limits, but a user may lower or raise the current limits 
within the legal range. 


Resources controllable currently include cputime (the maximum number of cpu-seconds to be used 
by each process), filesize (the largest single file which can be created), datasize (the maximum growth 
of the datat+stack region via sbrk(2) beyond the end of the program text), stacksize (the maximum 
size of the automatically-extended stack region), and coredumpsize (the size of the largest core dump 
that will be created). 


The maximum-use may be given as a (floating point or integer) number followed by a scale factor. 
For all limits other than cputime the default scale is ‘k’ or ‘kilobytes’ (1024 bytes); a scale factor of 
‘m’ or ‘megabytes’ may also be used. For cputime the default scaling is ‘seconds’, while “‘m’ for 
minutes or ‘h’ for hours, or a time of the form ‘mm:ss’ giving minutes and seconds may be used. 


For both resource names and scale factors, unambiguous prefixes of the names suffice. 


login 
Terminate a login shell, replacing it with an instance of /bin/login. This is one way to log off, 
included for compatibility with sh(1). 


logout 
Terminate a login shell. Especially useful if ignoreeof is set. 


nice 
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nice +number 

nice command 

nice +number command 
The first form sets the scheduling priority for this shell to 4. The second form sets the priority to the 
given number. The final two forms run command at priority 4 and number respectively. The greater 
the number, the less cpu the process will get. The super-user may specify negative priority by using 
“nice number ...’.. Command is always executed in a sub-shell, and the restrictions placed on com- 
mands in simple if statements apply. 


nohup 

nohup command 
The first form can be used in shell scripts to cause hangups to be ignored for the remainder of the 
script. The second form causes the specified command to be run with hangups ignored. All pro- 
cesses detached with ‘&’ are effectively nohup’ed. 


notify 

notify %job ... 
Causes the shell to notify the user asynchronously when the status of the current or specified jobs 
changes; normally notification is presented before a prompt. This is automatic if the shell variable 
notify is set. 


onintr 

onintr — 

onintr label 
Control the action of the shell on interrupts. The first form restores the default action of the shell on 
interrupts which is to terminate shell scripts or to return to the terminal command input level. The 
second form ‘onintr —’ causes all interrupts to be ignored. The final form causes the shell to execute a 
“goto label’ when an interrupt is received or a child process terminates because it was interrupted. 


In any case, if the shell is running detached and interrupts are being ignored, all forms of onintr have 
no meaning and interrupts continue to be ignored by the shell and all invoked commands. 


popd 

popd +n 
Pops the directory stack, returning to the new top directory. With an argument ‘+n’ discards the n th 
entry in the stack. The elements of the directory stack are numbered from 0 starting at the top. 


pushd 

pushd name 

pushd +n 
With no arguments, pushd exchanges the top two elements of the directory stack. Given a name 
argument, pushd changes to the new directory (ala cd) and pushes the old current working directory 
(as in csw) onto the directory stack. With a numeric argument, rotates the n th argument of the direc- 
tory stack around to be the top element and changes to it. The members of the directory stack are 
numbered from the top starting at 0. 


rehash 
Causes the internal hash table of the contents of the directories in the path variable to be recomputed. 
This is needed if new commands are added to directories in the path while you are logged in. This 
should only be necessary if you add commands to one of your own directories, or if a systems pro- 
grammer changes the contents of one of the system directories. 


repeat count command 
The specified command which is subject to the same restrictions as the command in the one line if 
statement above, is executed count times. I/O redirections occur exactly once, even if count is 0. 
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set 

set name 

set name=word 

set name[index ]=word 

set name=(wordlist) 
The first form of the command shows the value of all shell variables. Variables which have other 
than a single word as value print as a parenthesized word list. The second form sets name to the null 
string. The third form sets name to the single word. The fourth form sets the index’th component of 
name to word; this component must already exist. The final form sets name to the list of words in 
wordlist. In all cases the value is command and filename expanded. 


These arguments may be repeated to set multiple values in a single set command. Note however, that 
variable expansion happens for all arguments before any setting occurs. 


setenv 

setenv name value 

setenv name 
The first form lists all current environment variables. The last form sets the value of environment 
variable name to be value, a single string. The second form sets name to an empty string. The most 
commonly used environment variable USER, TERM, and PATH are automatically imported to and 
exported from the csh variables user, term, and path; there is no need to use setenv for these. 


shift 

shift variable 
The members of argv are shifted to the left, discarding argv/1]. It is an error for argv not to be set or 
to have less than one word as value. The second form performs the same function on the specified 
variable. 


source name 

source —h name 
The shell reads commands from name. Source commands may be nested; if they are nested too dee- 
ply the shell may run out of file descriptors. An error in a source at any level terminates all nested 
source commands. Normally input during source commands is not placed on the history list; the —h 
option causes the commands to be placed in the history list without being executed. 


stop 
stop Zojob ... 
Stops the current or specified job which is executing in the background. 


suspend 
Causes the shell to stop in its tracks, much as if it had been sent a stop signal with *Z. This is most 
often used to stop shells started by su(1). 


switch (string) 
case strl: 


breaksw 
default: 
breaksw 
endsw 
Each case label is successively matched, against the specified string which is first command and 
filename expanded. The file metacharacters ‘*’, ‘?’ and ‘[...]’ may be used in the case labels, which 
are variable expanded. If none of the labels match before a ‘default’ label is found, then the execu- 


tion begins after the default label. Each case label and the default label must appear at the beginning 
of a line. The command breaksw causes execution to continue after the endsw. Otherwise control 
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may fall through case labels and default labels as in C. If no label matches and there is no default, 
execution continues after the endsw. 


time 

time command 
With no argument, a summary of time used by this shell and its children is printed. If arguments are 
given the specified simple command is timed and a time summary as described under the time vari- 
able is printed. If necessary, an extra shell is created to print the time statistic when the command 
completes. 


umask 

umask value 
The file creation mask is displayed (first form) or set to the specified value (second form). The mask 
is given in octal. Common values for the mask are 002 giving all access to the group and read and 
execute access to others or 022 giving all access except no write access for users in the group or oth- 
ers. 


unalias pattern 
All aliases whose names match the specified pattern are discarded. Thus all aliases are removed by 
‘unalias *’. It is not an error for nothing to be unaliased. 


unhash 
Use of the internal hash table to speed location of executed programs is disabled. 


unlimit 

unlimit resource 

unlimit —h 

unlimit —h resource 
Removes the limitation on resource. If no resource is specified, then all resource limitations are 
removed. If —-h is given, the corresponding hard limits are removed. Only the super-user may do 
this. 


unset pattern 
All variables whose names match the specified pattern are removed. Thus all variables are removed 
by ‘unset *’; this has noticeably distasteful side-effects. It is not an error for nothing to be unset. 


unsetenv pattern 
Removes all variables whose name match the specified pattern from the environment. See also the 
setenv command above and printenv(1). 

wait 
All background jobs are waited for. It the shell is interactive, then an interrupt can disrupt the wait, 
at which time the shell prints names and job numbers of all jobs known to be outstanding. 


while (expr) 


end 


While the specified expression evaluates non-zero, the commands between the while and the match- 
ing end are evaluated. Break and continue may be used to terminate or continue the loop prema- 
turely. (The while and end must appear alone on their input lines.) Prompting occurs here the first 
time through the loop as for the foreach statement if the input is a terminal. 

%job 
Brings the specified job into the foreground. 

Jjob & 


Continues the specified job in the background. 
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@ name[index] = expr 
The first form prints the values of all the shell variables. The second form sets the specified name to 
the value of expr. If the expression contains “<’, ‘>’, ‘&’ or ‘ |’ then at least this part of the expression 
must be placed within ‘( ‘)’. The third form assigns the value of expr to the index’th argument of 
name. Both name and its index’th component must already exist. 


The operators ‘*=’, 


‘ 


+=’, etc are available as in C. The space separating the name from the assign- 


ment operator is optional. Spaces are, however, mandatory in separating components of expr which 
would otherwise be single words. 


Special postfix ‘++’ and ‘—-—’ operators increment and decrement name respectively, i.e. “@ i++’. 


Pre-defined and environment variables 


The following variables have special meaning to the shell. Of these, argv, cwd, home, path, prompt, shell 
and status are always set by the shell. Except for cwd and status this setting occurs only at initialization; 
these variables will not then be modified unless this is done explicitly by the user. 


This shell copies the environment variable USER into the variable user, TERM into term, and HOME into 
home, and copies these back into the environment whenever the normal shell variables are reset. The envi- 
ronment variable PATH is likewise handled; it is not necessary to worry about its setting other than in the 
file .cshrc as inferior csh processes will import the definition of path from the environment, and re-export it 
if you then change it. 


argv 


cdpath 
cwd 


echo 


filec 


histchars 


history 


home 


ignoreeof 


mail 
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Set to the arguments to the shell, it is from this variable that positional parameters are 
substituted, i.e. ‘$1’ is replaced by ‘$argv[1]’, etc. 


Gives a list of alternate directories searched to find subdirectories in chdir commands. 
The full pathname of the current directory. 


Set when the —x command line option is given. Causes each command and its arguments 
to be echoed just before it is executed. For non-builtin commands all expansions occur 
before echoing. Builtin commands are echoed before command and filename substitu- 
tion, since these substitutions are then done selectively. 


Enable file name completion. 


Can be given a string value to change the characters used in history substitution. The 
first character of its value is used as the history substitution character, replacing the 
default character !. The second character of its value replaces the character T in quick 
substitutions. 


Can be given a numeric value to control the size of the history list. Any command which 
has been referenced in this many events will not be discarded. Too large values of his- 
tory may run the shell out of memory. The last executed command is always saved on 
the history list. 


The home directory of the invoker, initialized from the environment. The filename 
expansion of “” refers to this variable. 


If set the shell ignores end-of-file from input devices which are terminals. This prevents 
shells from accidentally being killed by control-D’s. 


The files where the shell checks for mail. This is done after each command completion 
which will result in a prompt, if a specified interval has elapsed. The shell says “You 
have new mail.’ if the file exists with an access time not greater than its modify time. 


If the first word of the value of mail is numeric it specifies a different mail checking 
interval, in seconds, than the default, which is 10 minutes. 
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noclobber 


noglob 


nonomatch 


notify 


path 


prompt 


savehist 


shell 


status 


time 


verbose 
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If multiple mail files are specified, then the shell says ‘New mail in name’ when there is 
mail in the file name. 


As described in the section on Input/output, restrictions are placed on output redirection 
to insure that files are not accidentally destroyed, and that ‘>>’ redirections refer to exist- 
ing files. 


If set, filename expansion is inhibited. This is most useful in shell scripts which are not 
dealing with filenames, or after a list of filenames has been obtained and further expan- 
sions are not desirable. 


If set, it is not an error for a filename expansion to not match any existing files; rather the 
primitive pattern is returned. It is still an error for the primitive pattern to be malformed, 
i.e. “echo [’ still gives an error. 


If set, the shell notifies asynchronously of job completions. The default is to rather pre- 
sent job completions just before printing a prompt. 


Each word of the path variable specifies a directory in which commands are to be sought 
for execution. A null word specifies the current directory. If there is no path variable 
then only full path names will execute. The usual search path is ‘.’, ‘/bin’ and ‘/usr/bin’, 
but this may vary from system to system. For the super-user the default search path is 
‘letc’, ‘/bin’ and ‘/usr/bin’. A shell which is given neither the -c nor the -t option will 
normally hash the contents of the directories in the path variable after reading .cshrc, and 
each time the path variable is reset. If new commands are added to these directories 
while the shell is active, it may be necessary to give the rehash or the commands may 
not be found. 


The string which is printed before each command is read from an interactive terminal 
input. If a ‘!’ appears in the string it will be replaced by the current event number unless 
a preceding ‘\’ is given. Default is “% ’, or “#’ for the super-user. 


is given a numeric value to control the number of entries of the history list that are saved 
in ~/.history when the user logs out. Any command which has been referenced in this 
many events will be saved. During start up the shell sources ~/.history into the history 
list enabling history to be saved across logins. Too large values of savehist will slow 
down the shell during start up. 


The file in which the shell resides. This is used in forking shells to interpret files which 
have execute bits set, but which are not executable by the system. (See the description 
of Non-builtin Command Execution below.) Initialized to the (system-dependent) home 
of the shell. 


The status returned by the last command. If it terminated abnormally, then 0200 is 
added to the status. Builtin commands which fail return exit status ‘1’, all other builtin 
commands set status ‘0’. 


Controls automatic timing of commands. If set, then any command which takes more 
than this many cpu seconds will cause a line giving user, system, and real times and a 
utilization percentage which is the ratio of user plus system times to real time to be 
printed when it terminates. 


Set by the -v command line option, causes the words of each command to be printed 
after history substitution. 
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Non-builtin command execution 


When a command to be executed is found to not be a builtin command the shell attempts to execute the 
command via execve(2). Each word in the variable path names a directory from which the shell will 
attempt to execute the command. If it is given neither a -c nor a -t option, the shell will hash the names in 
these directories into an internal table so that it will only try an exec in a directory if there is a possibility 
that the command resides there. This greatly speeds command location when a large number of directories 
are present in the search path. If this mechanism has been turned off (via unhash), or if the shell was given 
a —c or -t argument, and in any case for each directory component of path which does not begin with a ‘/’, 
the shell concatenates with the given command name to form a path name of a file which it then attempts to 
execute. 


Parenthesized commands are always executed in a subshell. Thus ‘(cd ; pwd) ; pwd’ prints the home direc- 
tory; leaving you where you were (printing this after the home directory), while ‘cd ; pwd’ leaves you in the 
home directory. Parenthesized commands are most often used to prevent chdir from affecting the current 
shell. 


If the file has execute permissions but is not an executable binary to the system, then it is assumed to be a 
file containing shell commands and a new shell is spawned to read it. 


If there is an alias for shell then the words of the alias will be prepended to the argument list to form the 
shell command. The first word of the alias should be the full path name of the shell (e.g. ‘$shell’). Note 
that this is a special, late occurring, case of alias substitution, and only allows words to be prepended to the 
argument list without modification. 


Argument list processing 
If argument 0 to the shell is ‘—’ then this is a login shell. The flag arguments are interpreted as follows: 


-b This flag forces a ‘‘break’’ from option processing, causing any further shell arguments to be treated 
as non-option arguments. The remaining arguments will not be interpreted as shell options. This 
may be used to pass options to a shell script without confusion or possible subterfuge. The shell will 
not run a set-user ID script without this option. 


-c Commands are read from the (single) following argument which must be present. Any remaining 
arguments are placed in argv. 


-e The shell exits if any invoked command terminates abnormally or yields a non-zero exit status. 


-f The shell will start faster, because it will neither search for nor execute commands from the file 
“.cshre’ in the invoker’s home directory. 


-i_— The shell is interactive and prompts for its top-level input, even if it appears to not be a terminal. 
Shells are interactive without this option if their inputs and outputs are terminals. 


-—n Commands are parsed, but not executed. This aids in syntactic checking of shell scripts. 
-s Command input is taken from the standard input. 


-t A single line of input is read and executed. A ‘V may be used to escape the newline at the end of this 
line and continue onto another line. 


-v___ Causes the verbose variable to be set, with the effect that command input is echoed after history sub- 
stitution. 


-x Causes the echo variable to be set, so that commands are echoed immediately before execution. 
-V_ Causes the verbose variable to be set even before ‘.cshrc’ is executed. 
-X Is to-x as —-V is to -v. 


After processing of flag arguments, if arguments remain but none of the -c, +i, -s, or -t options was given, 
the first argument is taken as the name of a file of commands to be executed. The shell opens this file, and 
saves its name for possible resubstitution by ‘$0’. Since many systems use either the standard version 6 or 
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version 7 shells whose shell scripts are not compatible with this shell, the shell will execute such a ‘stan- 
dard’ shell if the first character of a script is not a ‘#’, i.e. if the script does not start with a comment. 
Remaining arguments initialize the variable argv. 


Signal handling 


The shell normally ignores quit signals. Jobs running detached (either by ‘&’ or the bg or %... & com- 
mands) are immune to signals generated from the keyboard, including hangups. Other signals have the val- 
ues which the shell inherited from its parent. The shells handling of interrupts and terminate signals in 
shell scripts can be controlled by onintr. Login shells catch the terminate signal; otherwise this signal is 
passed on to children from the state in the shell’s parent. In no case are interrupts allowed when a login 
shell is reading the file ‘logout’. 


AUTHOR 
William Joy. Job control and directory stack features first implemented by J.E. Kulp of I.1.A.S.A, Laxen- 
burg, Austria, with different syntax than that used now. File name completion code written by Ken Greer, 


HP Labs. 

FILES 
“/.cshre Read at beginning of execution by each shell. 
/ login Read by login shell, after ‘.cshrc’ at login. 
/ logout Read by login shell, at logout. 
/bin/sh Standard shell, for shell scripts not starting with a ‘#’. 
/tmp/sh* Temporary file for ‘<<’. 
/etc/passwd Source of home directories for “name’. 

LIMITATIONS 
Words can be no longer than 1024 characters. The system limits argument lists to 10240 characters. The 
number of arguments to a command which involves filename expansion is limited to 1/6’th the number of 
characters allowed in an argument list. Command substitutions may substitute no more characters than are 
allowed in an argument list. To detect looping, the shell restricts the number of alias substitutions on a sin- 
gle line to 20. 

SEE ALSO 
sh(1), access(2), execve(2), fork(2), killpg(2), pipe(2), sigvec(2), umask(2), setrlimit(2), wait(2), tty(4), 
a.out(5), environ(7), ‘An introduction to the C shell’ 

BUGS 


When a command is restarted from a stop, the shell prints the directory it started in if this is different from 
the current directory; this can be misleading (i.e. wrong) as the job may have changed directories internally. 


Shell builtin functions are not stoppable/restartable. Command sequences of the form ‘a ; b ; c’ are also not 
handled gracefully when stopping is attempted. If you suspend ‘b’, the shell will then immediately execute 
‘c’. This is especially noticeable if this expansion results from an alias. It suffices to place the sequence of 
commands in ()’s to force it to a subshell, i.e. ‘(a;b;c)’. 


Control over tty output after processes are started is primitive; perhaps this will inspire someone to work on 
a good virtual terminal interface. In a virtual terminal interface much more interesting things could be done 
with output control. 


Alias substitution is most often used to clumsily simulate shell procedures; shell procedures should be pro- 
vided rather than aliases. 


Commands within loops, prompted for by ‘?’, are not placed in the history list. Control structure should be 
parsed rather than being recognized as built-in commands. This would allow control commands to be 
placed anywhere, to be combined with ‘ |’, and to be used with ‘&’ and ‘;’ metasyntax. 


‘ 


It should be possible to use the ‘:’ modifiers on the output of command substitutions. All and more than 
one ‘:’ modifier should be allowed on ‘$’ substitutions. 
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The way the filec facility is implemented is ugly and expensive. 
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NAME 


ctags — create a tags file 


SYNOPSIS 


ctags [ -BFatuwvx ] [ -f tagsfile | name ... 


DESCRIPTION 


FILES 


Ctags makes a tags file for ex(1) from the specified C, Pascal, Fortran, YACC, lex, and lisp sources. A tags 
file gives the locations of specified objects (in this case functions and typedefs) in a group of files. Each 
line of the tags file contains the object name, the file in which it is defined, and an address specification for 
the object definition. Functions are searched with a pattern, typedefs with a line number. Specifiers are 
given in separate fields on the line, separated by blanks or tabs. Using the tags file, ex can quickly find 
these objects definitions. 


If the -x flag is given, ctags produces a list of object names, the line number and file name on which each is 
defined, as well as the text of that line and prints this on the standard output. This is a simple index which 
can be printed out as an off-line readable function index. 


If the —-v flag is given, an index of the form expected by vgrind(1) is produced on the standard output. This 
listing contains the function name, file name, and page number (assuming 64 line pages). Since the output 
will be sorted into lexicographic order, it may be desired to run the output through sort -f. Sample use: 
ctags —v files | sort -f > index 
verind —x index 


Normally ctags places the tag descriptions in a file called tags; this may be overridden with the -f option. 


Files whose names end in .c or .h are assumed to be C source files and are searched for C routine and macro 
definitions. Files whose names end in .y are assumed to be YACC source files. Files whose names end in 
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.l are assumed to be either lisp files if their first non-blank character is ‘;’, ‘(, or ‘[’, or lex files otherwise. 
Other files are first examined to see if they contain any Pascal or Fortran routine definitions; if not, they are 
processed again looking for C definitions. 


Other options are: 

-F _ use forward searching patterns (/.../) (default). 
-B _ use backward searching patterns (?...?). 

—a__—_ append to tags file. 

-t create tags for typedefs. 

-wW suppressing warning diagnostics. 


—u _ causing the specified files to be updated in tags, that is, all references to them are deleted, and the 
new values are appended to the file. (Beware: this option is implemented in a way which is rather 
slow; it is usually faster to simply rebuild the tags file.) 


The tag main is treated specially in C programs. The tag formed is created by prepending M to the name of 
the file, with a trailing .c removed, if any, and leading pathname components also removed. This makes use 
of ctags practical in directories with more than one program. 


tags output tags file 


SEE ALSO 


ex(1), vi(1) 


AUTHOR 


Ken Arnold; FORTRAN added by Jim Kleckner; Bill Joy added Pascal and -x, replacing cxref; C typedefs 
added by Ed Pelegri-Llopart. 
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BUGS 
Recognition of functions, subroutines and procedures for FORTRAN and Pascal is done is a very simple- 
minded way. No attempt is made to deal with block structure; if you have two Pascal procedures in differ- 
ent blocks with the same name you lose. 


The method of deciding whether to look for C or Pascal and FORTRAN functions is a hack. 
Does not know about #ifdefs. 


Should know about Pascal types. Relies on the input being well formed to detect typedefs. Use of -tx 
shows only the last line of typedefs. 
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NAME 


date — print and set the date 


SYNOPSIS 


date [ -n |] [-u ] [ yymmddhhmm [.ss ] ] 


DESCRIPTION 


FILES 


If no arguments are given, the current date and time are printed. Providing an argument will set the desired 
date. Only the superuser can set the date. The -u flag is used to display or set the date in GMT (universal) 
time. yy represents the last two digits of the year; the first mm is the month number; dd is the day number; 
hh is the hour number (24 hour system); the second mm is the minute number; .ss is optional and represents 
the seconds. For example: 


date 8506131627 


sets the date to June 13 1985, 4:27 PM. The year, month and day may be omitted; the default values will 
be the current ones. The system operates in GMT. Date takes care of the conversion to and from local 
standard and daylight-saving time. 


If timed(8) is running to synchronize the clocks of machines in a local area network, date sets the time glob- 
ally on all those machines unless the -n option is given. 


/usr/adm/wtmp to record time-setting. In /usr/adm/messages, date records the name of the user setting the 
time. 


SEE ALSO 


gettimeofday(2), utmp(5), timed(8), 
TSP: The Time Synchronization Protocol for UNIX 4.3BSD, R. Gusella and S. Zatti 


DIAGNOSTICS 


BUGS 


Exit status is 0 on success, | on complete failure to set the date, and 2 on successfully setting the local date 
but failing globally. 


“You are not superuser: date not set’ if you try to change the date but are not the super-user. Occasionally, 
when timed synchronizes the time on many hosts, the setting of a new time value may require more than a 
few seconds. On these occasions, date prints: ‘Network time being set’. The message ‘Communication 
error with timed’ occurs when the communication between date and timed fails. 


The system attempts to keep the date in a format closely compatible with VMS. VMS, however, uses local 
time (rather than GMT) and does not understand daylight-saving time. Thus, if you use both UNIX and 
VMS, VMS will be running on GMT. 
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NAME 


dbx — debugger 


SYNOPSIS 


dbx [ -r ] [-i] [-k ] [-I dir ] [ -c file ] [ objfile [ coredump }] 


DESCRIPTION 


Dbx is a tool for source level debugging and execution of programs under UNIX. The objfile is an object 
file produced by a compiler with the appropriate flag (usually ‘“-g’’) specified to produce symbol informa- 
tion in the object file. Currently, cc(1), f77(1), pc(1), and the DEC Western Research Laboratory Modula-2 
compiler, mod(1), produce the appropriate source information. The machine level facilities of dbx can be 
used on any program. 


The object file contains a symbol table that includes the name of the all the source files translated by the 
compiler to create it. These files are available for perusal while using the debugger. 


If a file named “‘core’’ exists in the current directory or a coredump file is specified, dbx can be used to 
examine the state of the program when it faulted. 


If the file ‘*.dbxinit’’ exists in the current directory then the debugger commands in it are executed. Dbx 
also checks for a ‘*‘.dbxinit’’ in the user’s home directory if there isn’t one in the current directory. 


The command line options and their meanings are: 
-r Execute objfile immediately. If it terminates successfully dbx exits. Otherwise the reason for ter- 


mination will be reported and the user offered the option of entering the debugger or letting the 
program fault. Dbx will read from ‘‘/dev/tty’’ when -r is specified and standard input is not a ter- 


minal. 
-i Force dbx to act as though standard input is a terminal. 
-k Map memory addresses, useful for kernel debugging. 


-Idir Add dir to the list of directories that are searched when looking for a source file. Normally dbx 
looks for source files in the current directory and in the directory where objfile is located. The 
directory search path can also be set with the use command. 


-c file | Execute the dbx commands in the file before reading from standard input. 


Unless -r is specified, dbx just prompts and waits for a command. 


Execution and Tracing Commands 


run [args] [< filename] [> filename] 

rerun [args] [< filename] [> filename] 
Start executing objfile, passing args as command line arguments; < or > can be used to redirect 
input or output in the usual manner. When rerun is used without any arguments the previous 
argument list is passed to the program; otherwise it is identical to run. If objfile has been written 
since the last time the symbolic information was read in, dbx will read in the new information. 


trace [in procedure/function] [if condition] 
trace source-line-number [if condition] 
trace procedure/function [in procedure/function] [if condition] 
trace expression at source-line-number [if condition] 
trace variable [in procedure/function] [if condition] 
Have tracing information printed when the program is executed. A number is associated with the 
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command that is used to turn the tracing off (see the delete command). 


The first argument describes what is to be traced. If it is a source-line-number, then the line is 
printed immediately prior to being executed. Source line numbers in a file other than the current 
one must be preceded by the name of the file in quotes and a colon, e.g. "mumble.p":17. 


If the argument is a procedure or function name then every time it is called, information is printed 
telling what routine called it, from what source line it was called, and what parameters were passed 
to it. In addition, its return is noted, and if it’s a function then the value it is returning is also 
printed. 


If the argument is an expression with an at clause then the value of the expression is printed when- 
ever the identified source line is reached. 


If the argument is a variable then the name and value of the variable is printed whenever it 
changes. Execution is substantially slower during this form of tracing. 


If no argument is specified then all source lines are printed before they are executed. Execution is 
substantially slower during this form of tracing. 


The clause ‘‘in procedure/function’’ restricts tracing information to be printed only while execut- 
ing inside the given procedure or function. 


Condition is a boolean expression and is evaluated prior to printing the tracing information; if it is 
false then the information is not printed. 


stop if condition 

stop at source-line-number [if condition] 

stop in procedure/function [if condition] 

stop variable [if condition] 
Stop execution when the given line is reached, procedure or function called, variable changed, or 
condition true. 


status [> filename] 
Print out the currently active trace and stop commands. 


delete command-number ... 
The traces or stops corresponding to the given numbers are removed. The numbers associated 
with traces and stops are printed by the status command. 


catch number 

catch signal-name 

ignore number 

ignore signal-name 
Start or stop trapping a signal before it is sent to the program. This is useful when a program 
being debugged handles signals such as interrupts. A signal may be specified by number or by a 
name (e.g., SIGINT). Signal names are case insensitive and the ‘‘SIG’’ prefix is optional. By 
default all signals are trapped except SIGCONT, SIGCHILD, SIGALRM and SIGKILL. 


cont integer 

cont signal-name 
Continue execution from where it stopped. Ifa signal is specified, the process continues as though 
it received the signal. Otherwise, the process is continued as though it had not been stopped. 
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Execution cannot be continued if the process has ‘‘finished’’, that is, called the standard procedure “‘exit’’. 
Dbx does not allow the process to exit, thereby letting the user to examine the program state. 


step Execute one source line. 


next —_ Execute up to the next source line. The difference between this and step is that if the line contains 
a call to a procedure or function the step command will stop at the beginning of that block, while 
the next command will not. 


return [procedure] 
Continue until a return to procedure is executed, or until the current procedure returns if none is 
specified. 


call procedure(parameters) 
Execute the object code associated with the named procedure or function. 


Printing Variables and Expressions 


Names are resolved first using the static scope of the current function, then using the dynamic scope if the 
name is not defined in the static scope. If static and dynamic searches do not yield a result, an arbitrary 
symbol is chosen and the message ‘‘[using qualified name]’’ is printed. The name resolution procedure 
may be overridden by qualifying an identifier with a block name, e.g., ‘‘module.variable’’. For C, source 
files are treated as modules named by the file name without “*.c’’. 


Expressions are specified with an approximately common subset of C and Pascal (or equivalently Modula- 
2) syntax. Indirection can be denoted using either a prefix “‘*’’ or a postfix ““”’ and array expressions are 


subscripted by brackets (‘‘[ ]’’). The field reference operator (‘‘.’”) can be used with pointers as well as 
records, making the C operator ‘‘->’’ unnecessary (although it is supported). 


Types of expressions are checked; the type of an expression may be overridden by using “‘type- 
name(expression)’’. When there is no corresponding named type the special constructs ‘‘&type-name’’ and 
‘‘$$tag-name’’ can be used to represent a pointer to a named type or C structure tag. 


assign variable = expression 
Assign the value of the expression to the variable. 


dump [procedure] [> filename] 
Print the names and values of variables in the given procedure, or the current one if none is 
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specified. If the procedure given is ‘‘.’’, then the all active variables are dumped. 


print expression [, expression ...] 
Print out the values of the expressions. 


whatis name 
Print the declaration of the given name, which may be qualified with block names as above. 


which identifier 
Print the full qualification of the given identifer, i.e. the outer blocks that the identifier is associ- 
ated with. 


up [count] 

down [count] 
Move the current function, which is used for resolving names, up or down the stack count levels. 
The default count is 1. 


where Print out a list of the active procedures and function. 


whereis identifier 
Print the full qualification of all the symbols whose name matches the given identifier. The order 
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in which the symbols are printed is not meaningful. 
Accessing Source Files 


/regular expression|/] 
?regular expression|[?] 
Search forward or backward in the current source file for the given pattern. 


edit [filename] 

edit procedure/function-name 
Invoke an editor on filename or the current source file if none is specified. If a procedure or func- 
tion name is specified, the editor is invoked on the file that contains it. Which editor is invoked by 
default depends on the installation. The default can be overridden by setting the environment vari- 
able EDITOR to the name of the desired editor. 


file [filename] 
Change the current source file name to filename. If none is specified then the current source file 
name is printed. 


func [procedure/function] 
Change the current function. If none is specified then print the current function. Changing the 
current function implicitly changes the current source file to the one that contains the function; it 
also changes the current scope used for name resolution. 


list [source-line-number [, source-line-number]] 

list procedure/function 
List the lines in the current source file from the first line number to the second inclusive. If no 
lines are specified, the next 10 lines are listed. If the name of a procedure or function is given lines 
n-k to n+k are listed where n is the first statement in the procedure or function and k is small. 


use directory-list 
Set the list of directories to be searched when looking for source files. 


Command Aliases and Variables 


alias name name 

alias name ‘‘string’’ 

alias name (parameters) “‘string’’ 
When commands are processed, dbx first checks to see if the word is an alias for either a command 
or a string. If it is an alias, then dbx treats the input as though the corresponding string (with val- 
ues substituted for any parameters) had been entered. For example, to define an alias “‘rr’’ for the 
command ‘‘rerun’’, one can say 


alias rr rerun 
To define an alias called ‘‘b’’ that sets a stop at a particular line one can say 
alias b(x) “‘stop at x’’ 


Subsequently, the command ‘‘b(12)’’ will expand to ‘‘stop at 12’’. 


set name [= expression] 
The set command defines values for debugger variables. The names of these variables cannot 
conflict with names in the program being debugged, and are expanded to the corresponding 
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expression within other commands. The following variables have a special meaning: 


$frame 
Setting this variable to an address causes dbx to use the stack frame pointed to by the 
address for doing stack traces and accessing local variables. This facility is of particular 
use for kernel debugging. 


$hexchars 

$hexints 

$hexoffsets 

$hexstrings 
When set, dbx prints out out characters, integers, offsets from registers, or character 
pointers respectively in hexadecimal. 


$listwindow 
The value of this variable specifies the number of lines to list around a function or when 
the list command is given without any parameters. Its default value is 10. 


$mapaddrs 
Setting (unsetting) this variable causes dbx to start (stop) mapping addresses. As with 
‘*$frame’’, this is useful for kernel debugging. 


$unsafecall 

$unsafeassign 
When ‘‘$unsafecall’’ is set, strict type checking is turned off for arguments to subroutine 
or function calls (e.g. in the call statement). When ‘‘$unsafeassign’’ is set, strict type 
checking between the two sides of an assign statement is turned off. These variables 
should be used only with great care, because they severely limit dbx’s usefulness for 
detecting errors. 


unalias name 
Remove the alias with the given name. 


unset name 
Delete the debugger variable associated with name. 


Machine Level Commands 


tracei [address] [if cond] 
tracei [variable] [at address] [if cond] 
stopi [address] [if cond] 
stopi [at] [address] [if cond] 
Turn on tracing or set a stop using a machine instruction address. 


stepi 
nexti Single step as in step or next, but do a single instruction rather than source line. 


address ,address/ [mode] 
address | [count] [mode] 
Print the contents of memory starting at the first address and continuing up to the second address 
or until count items are printed. If the address is ‘‘.’’, the address following the one printed most 
recently is used. The mode specifies how memory is to be printed; if it is omitted the previous 


mode specified is used. The initial mode is ““X’’. The following modes are supported: 
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print the machine instruction 

print a short word in decimal 

print a long word in decimal 

print a short word in octal 

print a long word in octal 

print a short word in hexadecimal 
print a long word in hexadecimal 
print a byte in octal 

print a byte as a character 

print a string of characters terminated by a null byte 
print a single precision real number 
print a double precision real number 


wmamnasrenocupa™ 


Symbolic addresses are specified by preceding the name with an ‘‘&’’. Registers are denoted by ‘‘$rN”’ 
where N is the number of the register. Addresses may be expressions made up of other addresses and the 
operators ‘*+’’, “‘-’’, and indirection (unary ‘‘*’’). 


Miscellaneous Commands 


gripe Invoke a mail program to send a message to the person in charge of dbx. 
help Print out a synopsis of dbx commands. 
quit Exit dbx. 


sh command-line 
Pass the command line to the shell for execution. The SHELL environment variable determines 
which shell is used. 


source filename 
Read dbx commands from the given filename. 


FILES 
a.out object file 
.dbxinit initial commands 
SEE ALSO 


cc(1), £77(1), pe(1), mod(1) 


COMMENTS 


Dbx suffers from the same ‘‘multiple include’’ malady as did sdb. If you have a program consisting of a 
number of object files and each is built from source files that include header files, the symbolic information 
for the header files is replicated in each object file. Since about one debugger start-up is done for each link, 
having the linker (ld) re-organize the symbol information would not save much time, though it would 
reduce some of the disk space used. 


This problem is an artifact of the unrestricted semantics of #include’s in C; for example an include file can 
contain static declarations that are separate entities for each file in which they are included. However, even 
with Modula-2 there is a substantial amount of duplication of symbol information necessary for inter- 
module type checking. 


Some problems remain with the support for individual languages. Fortran problems include: inability to 
assign to logical, logical*2, complex and double complex variables; inability to represent parameter con- 
stants which are not type integer or real; peculiar representation for the values of dummy procedures (the 
value shown for a dummy procedure is actually the first few bytes of the procedure text; to find the location 
of the procedure, use ‘‘&’’ to take the address of the variable). 
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UNIX Programmer’s Manual DC(1) 


dc — desk calculator 


SYNOPSIS 


de [ file ] 


DESCRIPTION 


De is an arbitrary precision arithmetic package. Ordinarily it operates on decimal integers, but one may 
specify an input base, output base, and a number of fractional digits to be maintained. The overall structure 
of dc is a stacking (reverse Polish) calculator. If an argument is given, input is taken from that file until its 
end, then from the standard input. The following constructions are recognized: 


number 


The value of the number is pushed on the stack. A number is an unbroken string of the digits 0-9. 
It may be preceded by an underscore _ to input a negative number. Numbers may contain decimal 
points. 


+ -/ * % * 


Sx 


7th Edition 


The top two values on the stack are added (+), subtracted (—), multiplied (*), divided (/), remain- 
dered (%), or exponentiated (“). The two entries are popped off the stack; the result is pushed on the 
stack in their place. Any fractional part of an exponent is ignored. 


The top of the stack is popped and stored into a register named x, where x may be any character. If 
the s is capitalized, x is treated as a stack and the value is pushed on it. 


The value in register x is pushed on the stack. The register x is not altered. All registers start with 
zero value. If the I is capitalized, register x is treated as a stack and its top value is popped onto the 
main stack. 


The top value on the stack is duplicated. 


The top value on the stack is printed. The top value remains unchanged. P interprets the top of the 
stack as an ascii string, removes it, and prints it. 


All values on the stack and in registers are printed. 


exits the program. If executing a string, the recursion level is popped by two. If q is capitalized, the 
top value on the stack is popped and the string execution level is popped by that value. 


treats the top element of the stack as a character string and executes it as a string of dc commands. 
replaces the number on the top of the stack with its scale factor. 
puts the bracketed ascii string onto the top of the stack. 


=x 
The top two elements of the stack are popped and compared. Register x is executed if they obey the 
stated relation. 


replaces the top element on the stack by its square root. Any existing fractional part of the argument 
is taken into account, but otherwise the scale factor is ignored. 


interprets the rest of the line as a UNIX command. 
All values on the stack are popped. 


The top value on the stack is popped and used as the number radix for further input. I pushes the 
input base on the top of the stack. 


The top value on the stack is popped and used as the number radix for further output. 
pushes the output base on the top of the stack. 


the top of the stack is popped, and that value is used as a non-negative scale factor: the appropriate 
number of places are printed on output, and maintained during multiplication, division, and 
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exponentiation. The interaction of scale factor, input base, and output base will be reasonable if all 
are changed together. 


Z The stack level is pushed onto the stack. 
Z replaces the number on the top of the stack with its length. 
9 


A line of input is taken from the input source (usually the terminal) and executed. 
33 are used by bc for array operations. 
An example which prints the first ten values of n! is 
[lal+dsa*plal0>y]sy 
Osal 
lyx 
SEE ALSO 
bc(1), which is a preprocessor for dc providing infix notation and a C-like syntax which implements func- 
tions and reasonable control structures for programs. 
DIAGNOSTICS 
“x is unimplemented’ where x is an octal number. 
“stack empty’ for not enough elements on the stack to do what was asked. 
“Out of space’ when the free list is exhausted (too many digits). 
“Out of headers’ for too many numbers being kept around. 


‘Out of pushdown’ for too many items on the stack. 
‘Nesting Depth’ for too many levels of nested execution. 
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NAME 
dd — convert and copy a file 


SYNOPSIS 
dd [option=value] ... 


DESCRIPTION 
Dd copies the specified input file to the specified output with possible conversions. The standard input and 
output are used by default. The input and output block size may be specified to take advantage of raw 


physical I/O. 
option values 
if= input file name; standard input is default 
of= output file name; standard output is default 
ibs=n input block size n bytes (default 512) 
obs=n output block size (default 512) 
bs=n set both input and output block size, superseding ibs and obs; also, if no conversion is 
specified, it is particularly efficient since no copy need be done 
cbs=n conversion buffer size 
skip=n skip n input records before starting copy 
files=n copy input files before terminating (makes sense only where input is a magtape or sim- 
ilar device). 
seek=n seek n records from beginning of output file before copying 
count=n copy only n input records 
conv=ascii convert EBCDIC to ASCII 
ebcdic convert ASCII to EBCDIC 
ibm slightly different map of ASCII to EBCDIC 
block convert variable length records to fixed length 
unblock convert fixed length records to variable length 
Icase map alphabetics to lower case 
ucase map alphabetics to upper case 
swab swap every pair of bytes 
noerror do not stop processing on an error 
sync pad every input record to ibs 


Ait several comma-separated conversions 


Where sizes are specified, a number of bytes is expected. A number may end with k, b or w to specify mul- 
tiplication by 1024, 512, or 2 respectively; a pair of numbers may be separated by x to indicate a product. 


Cbs is used only if ascii, unblock, ebcdic, ibm, or block conversion is specified. In the first two cases, cbs 
characters are placed into the conversion buffer, any specified character mapping is done, trailing blanks 
trimmed and new-line added before sending the line to the output. In the latter three cases, characters are 
read into the conversion buffer, and blanks added to make up an output record of size cbs. 

After completion, dd reports the number of whole and partial input and output blocks. 


For example, to read an EBCDIC tape blocked ten 80-byte EBCDIC card images per record into the ASCII 
file x: 


dd if=/dev/rmt0 of=x ibs=800 cbs=80 conv=ascii,lcase 


Note the use of raw magtape. Dd is especially suited to I/O on the raw physical devices because it allows 
reading and writing in arbitrary record sizes. 


SEE ALSO 
ep(1), tr) 
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DIAGNOSTICS 
f+p records in(out): numbers of full and partial records read(written) 


BUGS 
The ASCII/EBCDIC conversion tables are taken from the 256 character standard in the CACM Nov, 1968. 
The ‘ibm’ conversion, while less blessed as a standard, corresponds better to certain IBM print train con- 
ventions. There is no universal solution. 
One must specify ‘‘conv=noerror,sync’’ when copying raw disks with bad sectors to insure dd stays syn- 
chronized. 


Certain combinations of arguments to conv= are permitted. However, the block or unblock option cannot 
be combined with ascii, ebcdic or ibm. Invalid combinations silently ignore all but the last mutually- 
exclusive keyword. 
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NAME 

deroff — remove nroff, troff, tbl and eqn constructs 
SYNOPSIS 

deroff [ —w ] file ... 
DESCRIPTION 


Deroff reads each file in sequence and removes all nroff and troff command lines, backslash constructions, 
macro definitions, egn constructs (between ‘.EQ’ and ‘.EN’ lines or between delimiters), and table descrip- 
tions and writes the remainder on the standard output. Deroff follows chains of included files (‘.so’ and 
‘nx’ commands); if a file has already been included, a ‘.so’ is ignored and a ‘.nx’ terminates execution. If 
no input file is given, deroff reads from the standard input file. 


If the —w flag is given, the output is a word list, one ‘word’ (string of letters, digits, and apostrophes, begin- 
ning with a letter; apostrophes are removed) per line, and all other characters ignored. Otherwise, the out- 
put follows the original, with the deletions mentioned above. 


SEE ALSO 
troff(1), eqn(1), tbl(1) 


BUGS 
Deroff is not a complete troff interpreter, so it can be confused by subtle constructs. Most errors result in 
too much rather than too little output. 
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NAME 
df — disk free 


SYNOPSIS 
df [ -i ] [ filesystem ... ] [ file ... ] 


DESCRIPTION 
Df prints out the amount of free disk space available on the specified filesystem, e.g. “‘/dev/rp0a’’, or on the 
filesystem in which the specified file, e.g. ‘“$SHOME’’, is contained. If no file system is specified, the free 
space on all of the normally mounted file systems is printed. The reported numbers are in kilobytes. 


Other options are: 


-i Report also the number of inodes which are used and free. 
FILES 

/etc/fstab list of normally mounted filesystems 
SEE ALSO 


fstab(5), icheck(8), quot(8) 
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NAME 

diction, explain — print wordy sentences; thesaurus for diction 
SYNOPSIS 

diction [ —ml ] [-mm ] [ -n ] [ -f pfile ] file ... 

explain 
DESCRIPTION 


Diction finds all sentences in a document that contain phrases from a data base of bad or wordy diction. 
Each phrase is bracketed with [ ]. Because diction runs deroff before looking at the text, formatting header 
files should be included as part of the input. The default macro package —ms may be overridden with the 
flag -mm. The flag -ml which causes deroff to skip lists, should be used if the document contains many 
lists of non-sentences. The user may supply her/his own pattern file to be used in addition to the default file 
with -f pfile. If the flag -n is also supplied the default file will be suppressed. 


Explain is an interactive thesaurus for the phrases found by diction. 


SEE ALSO 
deroff(1) 


BUGS 
Use of non-standard formatting macros may cause incorrect sentence breaks. In particular, diction doesn’t 
grok —me. 
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NAME 
diff — differential file and directory comparator 


SYNOPSIS 
diff [-1] [-r] [-s ] [-cefhn ] [ -biwt ] dir] dir2 
diff [ -cefhn ] [ -biwt ] file! file2 
diff [ -Dszring ] [ -biw ] file] file2 


DESCRIPTION 
If both arguments are directories, diff sorts the contents of the directories by name, and then runs the regular 
file diff algorithm (described below) on text files which are different. Binary files which differ, common 
subdirectories, and files which appear in only one directory are listed. Options when comparing directories 


are: 

-l long output format; each text file diff is piped through pr(1) to paginate it, other differences are 
remembered and summarized after all text file differences are reported. 

-r causes application of diff recursively to common subdirectories encountered. 

-s causes diff to report files which are the same, which are otherwise not mentioned. 

—Sname 


starts a directory diff in the middle beginning with file name. 


When run on regular files, and when comparing text files which differ during directory comparison, diff 
tells what lines must be changed in the files to bring them into agreement. Except in rare circumstances, 
diff finds a smallest sufficient set of file differences. If neither file/ nor file2 is a directory, then either may 
be given as ‘—’, in which case the standard input is used. If file/ is a directory, then a file in that directory 
whose file-name is the same as the file-name of file2 is used (and vice versa). 


There are several options for output format; the default output format contains lines of these forms: 


nl an3,n4 
nl,n2 dn3 
nl,n2 c n3,n4 


These lines resemble ed commands to convert file/ into file2. The numbers after the letters pertain to file2. 
In fact, by exchanging ‘a’ for ‘d’ and reading backward one may ascertain equally how to convert file2 into 
filel. As in ed, identical pairs where n/ = n2 or n3 = n4 are abbreviated as a single number. 


Following each of these lines come all the lines that are affected in the first file flagged by ‘<’, then all the 
lines that are affected in the second file flagged by ‘>’. 


Except for -b, -w, -i or -t which may be given with any of the others, the following options are mutually 
exclusive: 


-e produces a script of a, c and d commands for the editor ed, which will recreate file2 from file! . 
In connection with —e, the following shell program may help maintain multiple versions of a 
file. Only an ancestral file ($1) and a chain of version-to-version ed scripts ($2,$3,...) made by 
diff need be on hand. A ‘latest version’ appears on the standard output. 


(shift; cat $*; echo *1,$p’) | ed-$1 


Extra commands are added to the output when comparing directories with —e, so that the result 
is a sh(1) script for converting text files which are common to the two directories from their 
state in dir/ to their state in dir2. 


-f produces a script similar to that of -e, not useful with ed, and in the opposite order. 


—n produces a script similar to that of -e, but in the opposite order and with a count of changed 
lines on each insert or delete command. This is the form used by rcsdiff(1). 
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— produces a diff with lines of context. The default is to present 3 lines of context and may be 
changed, e.g to 10, by -c10. With —c the output format is modified slightly: the output begin- 
ning with identification of the files involved and their creation dates and then each change is 
separated by a line with a dozen *’s. The lines removed from file] are marked with ‘— ’; those 
added to file2 are marked ‘+’. Lines which are changed from one file to the other are marked in 
both files with with ‘! ’. 

Changes which lie within <context> lines of each other are grouped together on output. (This is 
a change from the previous ‘‘diff -c’’ but the resulting output is usually much easier to inter- 
pret.) 

-h does a fast, half-hearted job. It works only when changed stretches are short and well separated, 
but does work on files of unlimited length. 

-Dstring causes diff to create a merged version of file/ and file2 on the standard output, with C preproces- 
sor controls included so that a compilation of the result without defining string is equivalent to 
compiling file/, while defining string will yield file2. 

—b causes trailing blanks (spaces and tabs) to be ignored, and other strings of blanks to compare 
equal. 

-w is similar to —b but causes whitespace (blanks and tabs) to be totally ignored. E.g., 
“af (a ==b )’’ will compare equal to ‘‘if(a==b)’’. 

-i ignores the case of letters. E.g., ‘“A’’ will compare equal to “‘a’’. 

-t will expand tabs in output lines. Normal or —-c output adds character(s) to the front of each line 
which may screw up the indentation of the original source lines and make the output listing 
difficult to interpret. This option will preserve the original source’s indentation. 

FILES 
/tmp/d????? 
/asr/lib/diffh for —h 
/bin/diff for directory diffs 
/bin/pr 
SEE ALSO 

cmp(1), cc(1), comm(1), ed(1), diff3(1) 
DIAGNOSTICS 

Exit status is O for no differences, 1 for some, 2 for trouble. 
BUGS 


Editing scripts produced under the —-e or -f option are naive about creating lines consisting of a single ‘.’. 


When comparing directories with the —b, -w or -i options specified, diff first compares the files ala cmp, and 
then decides to run the diff algorithm if they are not equal. This may cause a small amount of spurious out- 
put if the files then turn out to be identical because the only differences are insignificant blank string or case 
differences. 
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NAME 


diff3 — 3-way differential file comparison 


SYNOPSIS 


diff3 [ -exEX3 ] file! file2 file3 


DESCRIPTION 


FILES 


Diff3 compares three versions of a file, and publishes disagreeing ranges of text flagged with these codes: 
==== all three files differ 

=== file1 is different 

———— file2 is different 

a file3 is different 


The type of change suffered in converting a given range of a given file to some other is indicated in one of 
these ways: 


finla Text is to be appended after line number n/ in file f where f= 1, 2, or 3. 


finl ,n2¢ Text is to be changed in the range line n/ to line n2. If nl = n2, the range may be 
abbreviated to n/. 


The original contents of the range follows immediately after a c indication. When the contents of two files 
are identical, the contents of the lower-numbered file is suppressed. 


Under the -e option, diff3 publishes a script for the editor ed that will incorporate into file/ all changes 
between file2 and file3, i.e. the changes that normally would be flagged ==== and ====3. Option —x (-3) 
produces a script to incorporate only changes flagged ==== (====3). The following command will apply 
the resulting script to ‘filel’. 


(cat script; echo “1,$p’) | ed — file1 


The —E and —X are similar to -e and -x, respectively, but treat overlapping changes (i.e., changes that 
would be flagged with ==== in the normal listing) differently. The overlapping lines from both files will be 
inserted by the edit script, bracketed by "<<<<<<" and ">>>>>>" lines. 


For example, suppose lines 7-8 are changed in both filel and file2. Applying the edit script generated by 
the command 

"diff3 -E file! file2 file3" 
to file1 results in the file: 


lines 1-6 

of file1 
<<<<<<< filel 
lines 7-8 

of file1 


lines 7-8 

of file3 
>>>>>>> file3 
rest of filel 


The —E option is used by RCS merge(1) to insure that overlapping changes in the merged files are pre- 
served and brought to someone’s attention. 


/ust/lib/diff3 
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SEE ALSO 
diff(1) 


BUGS 
Text lines that consist of a single ‘.’ will defeat —e. 
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NAME 

du — summarize disk usage 
SYNOPSIS 

du [-s][-a][name... ] 
DESCRIPTION 


Du gives the number of kilobytes contained in all files and, recursively, directories within each specified 


6° 


directory or file name. If name is missing, ‘.’ is used. 


The argument —s causes only the grand total to be given. The argument —a causes an entry to be generated 
for each file. Absence of either causes an entry to be generated for each directory only. 


A file which has two links to it is only counted once. 


SEE ALSO 
df(1), quot(8) 


BUGS 
Non-directories given as arguments (not under —a option) are not listed. 
If there are too many distinct linked files, du counts the excess files multiply. 
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NAME 

echo — echo arguments 
SYNOPSIS 

echo [ -n ] [ arg]... 
DESCRIPTION 


Echo writes its arguments separated by blanks and terminated by a newline on the standard output. If the 
flag —n is used, no newline is added to the output. 


Echo is useful for producing diagnostics in shell programs and for writing constant data on pipes. To send 
diagnostics to the standard error file, do “echo ... 1>&2’. 
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ed — text editor 


SYNOPSIS 


ed [-—] [—-x ] [ name ] 


DESCRIPTION 


Ed is the standard text editor. 


If a name argument is given, ed simulates an e command (see below) on the named file; that is to say, the 
file is read into ed’s buffer so that it can be edited. If —x is present, an x command is simulated first to han- 
dle an encrypted file. The optional - suppresses the printing of explanatory output and should be used 
when the standard input is an editor script. 


Ed operates on a copy of any file it is editing; changes made in the copy have no effect on the file until a w 
(write) command is given. The copy of the text being edited resides in a temporary file called the buffer. 


Commands to ed have a simple and regular structure: zero or more addresses followed by a single character 
command, possibly followed by parameters to the command. These addresses specify one or more lines in 
the buffer. Missing addresses are supplied by default. 


In general, only one command may appear on a line. Certain commands allow the addition of text to the 
buffer. While ed is accepting text, it is said to be in input mode. In this mode, no commands are recog- 
nized; all input is merely collected. Input mode is left by typing a period *.’ alone at the beginning of a line. 


Ed supports a limited form of regular expression notation. A regular expression specifies a set of strings of 
characters. A member of this set of strings is said to be matched by the regular expression. In the follow- 
ing specification for regular expressions the word ‘character’ means any character but newline. 


1. Any character except a special character matches itself. Special characters are the regular expres- 
sion delimiter plus \[. and sometimes ** $. 


2. A .. matches any character. 
a A \ followed by any character except a digit or () matches that character. 
4, A nonempty string s bracketed [s ] (or [*s ]) matches any character in (or not in) s. In s, \ has no 


special meaning, and ] may only appear as the first letter. A substring a—b, with a and b in ascend- 
ing ASCII order, stands for the inclusive range of ASCII characters. 


5. A regular expression of form 1-4 followed by * matches a sequence of 0 or more matches of the 
regular expression. 


6. A regular expression, x, of form 1-8, bracketed \(x \) matches what x matches. 


A \ followed by a digit n matches a copy of the string that the bracketed regular expression begin- 
ning with the nth \( matched. 


8. A regular expression of form 1-8, x, followed by a regular expression of form 1-7, y matches a 
match for x followed by a match for y, with the x match being as long as possible while still per- 
mitting a y match. 


9: A regular expression of form 1-8 preceded by * (or followed by $), is constrained to matches that 
begin at the left (or end at the right) end of a line. 

10. A regular expression of form 1-9 picks out the longest among the leftmost matches in a line. 

11. An empty regular expression stands for a copy of the last regular expression encountered. 


Regular expressions are used in addresses to specify lines and in one command (see s below) to specify a 
portion of a line which is to be replaced. If it is desired to use one of the regular expression metacharacters 
as an ordinary character, that character may be preceded by ‘\’. This also applies to the character bounding 
the regular expression (often ‘/’) and to ‘\V itself. 
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To understand addressing in ed it is necessary to know that at any time there is a current line. Generally 
speaking, the current line is the last line affected by a command; however, the exact effect on the current 
line is discussed under the description of the command. Addresses are constructed as follows. 


1. The character ‘.’ addresses the current line. 

2 The character ‘$’ addresses the last line of the buffer. 

3. A decimal number n addresses the n-th line of the buffer. 

4 ‘’x’ addresses the line marked with the name x, which must be a lower-case letter. Lines are 


marked with the k command described below. 


5. A regular expression enclosed in slashes ‘/’ addresses the line found by searching forward from the 
current line and stopping at the first line containing a string that matches the regular expression. If 
necessary the search wraps around to the beginning of the buffer. 


6. A regular expression enclosed in queries ‘?’ addresses the line found by searching backward from 
the current line and stopping at the first line containing a string that matches the regular expres- 
sion. If necessary the search wraps around to the end of the buffer. 


7. An address followed by a plus sign ‘+’ or a minus sign —’ followed by a decimal number specifies 
that address plus (resp. minus) the indicated number of lines. The plus sign may be omitted. 


8. If an address begins with ‘+’ or ‘—’ the addition or subtraction is taken with respect to the current 
line; e.g. ‘—5’ is understood to mean ‘.—5’. 


9: If an address ends with ‘+’ or ‘—’, then | is added (resp. subtracted). As a consequence of this rule 
and rule 8, the address ‘“—’ refers to the line before the current line. Moreover, trailing ‘+’ and ‘—’ 
characters have cumulative effect, so ‘—’ refers to the current line less 2. 

10. To maintain compatibility with earlier versions of the editor, the character ‘~’ in addresses is 


equivalent to ‘—’. 


Commands may require zero, one, or two addresses. Commands which require no addresses regard the 
presence of an address as an error. Commands which accept one or two addresses assume default addresses 
when insufficient are given. If more addresses are given than such a command requires, the last one or two 
(depending on what is accepted) are used. 


Addresses are separated from each other typically by a comma ‘,’. They may also be separated by a semi- 
colon ‘;’. In this case the current line *.’ is set to the previous address before the next address is interpreted. 
This feature can be used to determine the starting line for forward and backward searches (‘/’, ‘?’). The 
second address of any two-address sequence must correspond to a line following the line corresponding to 
the first address. The special form ‘%’ is an abbreviation for the address pair ‘1,$’. 


In the following list of ed commands, the default addresses are shown in parentheses. The parentheses are 
not part of the address, but are used to show that the given addresses are the default. 


As mentioned, it is generally illegal for more than one command to appear on a line. However, most com- 
mands may be suffixed by ‘p’ or by ‘I’, in which case the current line is either printed or listed respectively 
in the way discussed below. Commands may also be suffixed by ‘n’, meaning the output of the command 
is to be line numbered. These suffixes may be combined in any order. 


(.)a 


<text> 


‘ 


The append command reads the given text and appends it after the addressed line. ‘.’ is left on the 
last line input, if there were any, otherwise at the addressed line. Address ‘0’ is legal for this com- 
mand; text is placed at the beginning of the buffer. 


(.,.)c 
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<text> 


The change command deletes the addressed lines, then accepts input text which replaces these lines. 
*.’ is left at the last line input; if there were none, it is left at the line preceding the deleted lines. 


(.,.)d 
The delete command deletes the addressed lines from the buffer. The line originally after the last line 
deleted becomes the current line; if the lines deleted were originally at the end, the new last line 
becomes the current line. 


e filename 
The edit command causes the entire contents of the buffer to be deleted, and then the named file to be 
read in. ‘.’ is set to the last line of the buffer. The number of characters read is typed. ‘filename’ is 
remembered for possible use as a default file name in a subsequent r or w command. If ‘filename’ is 


missing, the remembered name is used. 


E filename 
This command is the same as e, except that no diagnostic results when no w has been given since the 
last buffer alteration. 


f filename 
The filename command prints the currently remembered file name. If ‘filename’ is given, the cur- 
rently remembered file name is changed to ‘filename’. 


(1,$) g/regular expression/command list 
In the global command, the first step is to mark every line which matches the given regular expres- 
sion. Then for every such line, the given command list is executed with ‘.’ initially set to that line. A 
single command or the first of multiple commands appears on the same line with the global com- 
mand. All lines of a multi-line list except the last line must be ended with ‘\’. A, i, and c commands 
and associated input are permitted; the *.’ terminating input mode may be omitted if it would be on 
the last line of the command list. The commands g and v are not permitted in the command list. 


(.)i 


<text> 

This command inserts the given text before the addressed line. ‘.’ is left at the last line input, or, if 
there were none, at the line before the addressed line. This command differs from the a command 
only in the placement of the text. 


( ae +1)j 
This command joins the addressed lines into a single line; intermediate newlines simply disappear. 
*. is left at the resulting line. 


(.) kx 
The mark command marks the addressed line with name x, which must be a lower-case letter. The 
address form ‘’x’ then addresses this line. 


(.,-)1 
The list command prints the addressed lines in an unambiguous way: non-graphic characters are 
printed in two-digit octal, and long lines are folded. The / command may be placed on the same line 
after any non-i/o command. 


(.,.)ma 
The move command repositions the addressed lines after the line addressed by a. The last of the 
moved lines becomes the current line. 


( *972. ) Pp 
The print command prints the addressed lines. is left at the last line printed. The p command 
may be placed on the same line after any non-i/o command. 
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(.,)P 
This command is a synonym for p. 
q The quit command causes ed to exit. No automatic write of a file is done. 
Q This command is the same as g, except that no diagnostic results when no w has been given since the 
last buffer alteration. 
($)r filename 


The read command reads in the given file after the addressed line. If no file name is given, the 
remembered file name, if any, is used (see e and f commands). The file name is remembered if there 
was no remembered file name already. Address ‘0’ is legal for r and causes the file to be read at the 
beginning of the buffer. If the read is successful, the number of characters read is typed. ‘.’ is left at 
the last line read in from the file. 


(..,.)S/regular expression/replacement/ _ or, 
(..,.)S/regular expression/replacement/g 


The substitute command searches each addressed line for an occurrence of the specified regular 
expression. On each line in which a match is found, all matched strings are replaced by the replace- 
ment specified, if the global replacement indicator “g’ appears after the command. If the global indi- 
cator does not appear, only the first occurrence of the matched string is replaced. It is an error for the 
substitution to fail on all addressed lines. Any punctuation character may be used instead of ‘/’ to 
delimit the regular expression and the replacement. ‘.’ is left at the last line substituted. 


An ampersand ‘&’ appearing in the replacement is replaced by the string matching the regular 
expression. The special meaning of ‘&’ in this context may be suppressed by preceding it by ‘V. 
The characters ‘\n’ where n is a digit, are replaced by the text matched by the n-th regular subexpres- 
sion enclosed between ‘\( and ‘\)’. When nested, parenthesized subexpressions are present, 7 is 
determined by counting occurrences of ‘\( starting from the left. 


Lines may be split by substituting new-line characters into them. The new-line in the replacement 
string must be escaped by preceding it by ‘V. 


One or two trailing delimiters may be omitted, implying the “p’ suffix. The special form ‘s’ followed 
by no delimiters repeats the most recent substitute command on the addressed lines. The ‘s’ may be 
followed by the letters r (use the most recent regular expression for the left hand side, instead of the 
most recent left hand side of a substitute command), p (complement the setting of the p suffix from 
the previous substitution), or g (complement the setting of the g suffix). These letters may be com- 
bined in any order. 


(.,.)ta 


This command acts just like the m command, except that a copy of the addressed lines is placed after 
address a (which may be 0). ‘.’ is left on the last line of the copy. 


(.,.)uU 


The undo command restores the buffer to it’s state before the most recent buffer modifying com- 
mand. The current line is also restored. Buffer modifying commands are a, c, d, g, i, k, and v. For 
purposes of undo, g and v are considered to be a single buffer modifying command. Undo is its own 
inverse. 


When ed runs out of memory (at about 8000 lines on any 16 bit mini-computer such as the PDP-11) 
This full undo is not possible, and u can only undo the effect of the most recent substitute on the cur- 
rent line. This restricted undo also applies to editor scripts when ed is invoked with the - option. 


(1, $) v/regular expression/command list 


This command is the same as the global command g except that the command list is executed g with 
*. initially set to every line except those matching the regular expression. 


(1, $) w filename 
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created. The file name is remembered if there was no remembered file name already. If no file name 
is given, the remembered file name, if any, is used (see e and fcommands). ‘.’ is unchanged. If the 
command is successful, the number of characters written is printed. 


(1, $) W filename 
This command is the same as w, except that the addressed lines are appended to the file. 


(1, $) wq filename 
This command is the same as w except that afterwards a g command is done, exiting the editor after 
the file is written. 


X A key string is demanded from the standard input. Later r, e and w commands will encrypt and 
decrypt the text with this key by the algorithm of crypt(1). An explicitly empty key turns off encryp- 
tion. (.+1)z or, 

(.+1) zn 
This command scrolls through the buffer starting at the addressed line. 22 (or n, if given) lines are 
printed. The last line printed becomes the current line. The value v is sticky, in that it becomes the 
default for future z commands. 


($)= The line number of the addressed line is typed. ‘.’ is unchanged by this command. 


!<shell command> 
The remainder of the line after the 
unchanged. 
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is sent to sh(1) to be interpreted as a command. ‘.’ is 


op 


(.+1, .+1) <newline> 
An address alone on a line causes the addressed line to be printed. A blank line alone is equivalent to 
“+Ip’; it is useful for stepping through text. If two addresses are present with no intervening semi- 
colon, ed prints the range of lines. If they are separated by a semicolon, the second line is printed. 


If an interrupt signal (ASCII DEL) is sent, ed prints “?interrupted’ and returns to its command level. 


Some size limitations: 512 characters per line, 256 characters per global command list, 64 characters per 
file name, and, on mini computers, 128K characters in the temporary file. The limit on the number of lines 
depends on the amount of core: each line takes 2 words. 


When reading a file, ed discards ASCII NUL characters and all characters after the last newline. It refuses 
to read files containing non-ASCII characters. 


/tmp/e* 
edhup: work is saved here if terminal hangs up 


SEE ALSO 


B. W. Kernighan, A Tutorial Introduction to the ED Text Editor 
B. W. Kernighan, Advanced editing on UNIX 
ex(1), sed(1), crypt(1) 


DIAGNOSTICS 


BUGS 


“2name’ for inaccessible file; ‘?self-explanatory message’ for other errors. 


To protect against throwing away valuable work, a g or e command is considered to be in error, unless a w 
has occurred since the last buffer change. A second g or e will be obeyed regardless. 


The / command mishandles DEL. 
The undo command causes marks to be lost on affected lines. 
The x command, -x option, and special treatment of hangups only work on UNIX. 
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NAME 

efl — Extended Fortran Language 
SYNOPSIS 

efl [ option ... ] [ filename ... ] 
DESCRIPTION 


Efl compiles a program written in the EFL language into clean Fortran. Efl provides the same control flow 
constructs as does ratfor(1), which are essentially identical to those in C: 


statement grouping with braces; 
decision-making with if, if-else, and switch-case; while, for, Fortran do, repeat, and repeat...until 
loops; multi-level break and next. In addition, EFL has C-like data structures, and more uniform 
and convenient input/output syntax, generic functions. EFL also provides some syntactic sugar to 
make programs easier to read and write: 


free form input: 
multiple statements/line; automatic continuation statement label names (not just numbers), 


comments: 
# this is a comment 


translation of relationals: 
>, >=, etc., become .GT., .GE., etc. 


return (expression) 
returns expression to caller from function 


define: define name replacement 
include: include filename 


The Efl command option —w suppresses warning messages. The option -C causes comments to be copied 
through to the Fortran output (default); -# prevents comments from being copied through. If a command 
argument contains an embedded equal sign, that argument is treated as if it had appeared in an option state- 
ment at the beginning of the program. Eff is best used with f77(1). 


SEE ALSO 
f77(1), ratfor(1). 
S. I. Feldman, The Programming Language EFL, Rell Labs Computing Science Technical Report #78. 
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NAME 


delim $$ 


eqn, neqn, checkeq — typeset mathematics 


SYNOPSIS 


eqn [ -dxy ] [-pn] [-sn ] [-fn ] [ file ] ... 
checkeg [ file ] ... 


DESCRIPTION 


Eqn is a troff(1) preprocessor for typesetting mathematics on a Graphic Systems phototypesetter, neqn on 
terminals. Usage is almost always 


eqn file ... | troff 
neqn file ... | nroff 


If no files are specified, these programs read from the standard input. A line beginning with ‘.EQ’ marks 
the start of an equation; the end of an equation is marked by a line beginning with ‘.EN’. Neither of these 
lines is altered, so they may be defined in macro packages to get centering, numbering, etc. It is also possi- 
ble to set two characters as ‘delimiters’; subsequent text between delimiters is also treated as egn input. 
Delimiters may be set to characters x and y with the command-line argument —dxy or (more commonly) 
with ‘delim xy’ between .EQ and .EN. The left and right delimiters may be identical. Delimiters are turned 
off by ‘delim off’. All text that is neither between delimiters nor between .EQ and .EN is passed through 
untouched. 


The program checkeg reports missing or unbalanced delimiters and .EQ/.EN pairs. 


Tokens within egn are separated by spaces, tabs, newlines, braces, double quotes, tildes or circumflexes. 
Braces {} are used for grouping; generally speaking, anywhere a single character like x could appear, a 
complicated construction enclosed in braces may be used instead. Tilde ~ represents a full space in the out- 
put, circumflex * half as much. 


Subscripts and superscripts are produced with the keywords sub and sup. Thus x sub i makes $x sub i$, a 
sub i sup 2 produces $a sub i sup 2$, and e sup {x sup 2 + y sup 2} gives $e sup {x sup 2 + y sup 2}$. 


Fractions are made with over: a over b yields $a over b$. 
sqrt makes square roots: / over sqrt {ax sup 2 +bx+c} results in $1 over sqrt {ax sup 2 +bx+c}$ . 


The keywords from and to introduce lower and upper limits on arbitrary things: $lim from {n-> inf} sum 
from 0 to n x sub i$ is made with lim from {n—> inf } sum from 0 to n x sub i. 


Left and right brackets, braces, etc., of the right height are made with left and right: left [ x sup 2 + y sup 2 
over alpha right ] ~="1 produces $left [ x sup 2 + y sup 2 over alpha right ] ~="1$. The right clause is 
optional. Legal characters after left and right are braces, brackets, bars, c and f for ceiling and floor, and "" 
for nothing at all (useful for a right-side-only bracket). 


Vertical piles of things are made with pile, Ipile, cpile, and rpile: pile {a above b above c} produces $pile 
{a above b above c}$. There can be an arbitrary number of elements in a pile. Ipile left-justifies, pile and 
cpile center, with different vertical spacing, and rpile right justifies. 


Matrices are made with matrix: matrix { Icol { x sub i above y sub 2 } ccol { 1 above 2 } } produces $matrix 
{ Icol { x sub i above y sub 2 } ccol { 1 above 2 } }$. In addition, there is rcol for a right-justified column. 
Diacritical marks are made with dot, dotdot, hat, tilde, bar, vec, dyad, and under: x dot = f(t) bar is $x 


dot = f(t) bar$, y dotdot bar “=~n under is $y dotdot bar =" n under$, and x vec “=~ y dyad is $x vec =" y 
dyad$. 


Sizes and font can be changed with size n or size =n, roman, italic, bold, and font n. Size and fonts can be 
changed globally in a document by gsize n and gfont n, or by the command-line arguments -sn and —fn. 
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Normally subscripts and superscripts are reduced by 3 point sizes from the previous size; this may be 
changed by the command-line argument —pn. 


Successive display arguments can be lined up. Place mark before the desired lineup point in the first equa- 
tion; place lineup at the place that is to line up vertically in subsequent equations. 


Shorthands may be defined or existing keywords redefined with define: define thing % replacement % 
defines a new token called thing which will be replaced by replacement whenever it appears thereafter. The 
% may be any character that does not occur in replacement. 


Keywords like sum (sum ) int ( int ) inf (inf ) and shorthands like >= (>=) —> (->), and != ( != ) are recog- 
nized. Greek letters are spelled out in the desired case, as in alpha or GAMMA. Mathematical words like 
sin, cos, log are made Roman automatically. Troff(1) four-character escapes like \(bs (\) can be used any- 
where. Strings enclosed in double quotes "...". are passed through untouched; this permits keywords to be 
entered as text, and can be used to communicate with troff when all else fails. 

SEE ALSO 
troff(1), tbl(1), ms(7), eqnchar(7) 
B. W. Kernighan and L. L. Cherry, Typesetting Mathematics—User’s Guide 
J. F. Ossanna, NROFF/TROFF User’s Manual 


BUGS 
To embolden digits, parens, etc., it is necessary to quote them, as in ‘bold "12.3"”. 
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NAME 

error — analyze and disperse compiler error messages 
SYNOPSIS 

error [-n ][-s ] [-q ] [-v ] [ -t suffixlist ] [-I ignorefile ] [ name ] 
DESCRIPTION 


Error analyzes and optionally disperses the diagnostic error messages produced by a number of compilers 
and language processors to the source file and line where the errors occurred. It can replace the painful, tra- 
ditional methods of scribbling abbreviations of errors on paper, and permits error messages and source code 
to be viewed simultaneously without machinations of multiple windows in a screen editor. 


Error looks at the error messages, either from the specified file name or from the standard input, and 
attempts to determine which language processor produced each error message, determines the source file 
and line number to which the error message refers, determines if the error message is to be ignored or not, 
and inserts the (possibly slightly modified) error message into the source file as a comment on the line pre- 
ceding to which the line the error message refers. Error messages which can’t be categorized by language 
processor or content are not inserted into any file, but are sent to the standard output. Error touches source 
files only after all input has been read. By specifying the -q query option, the user is asked to confirm any 
potentially dangerous (such as touching a file) or verbose action. Otherwise error proceeds on its merry 
business. If the —-t touch option and associated suffix list is given, error will restrict itself to touch only 
those files with suffices in the suffix list. Error also can be asked (by specifying —v) to invoke vi(1) on the 
files in which error messages were inserted; this obviates the need to remember the names of the files with 
errors. 


Error is intended to be run with its standard input connected via a pipe to the error message source. Some 
language processors put error messages on their standard error file; others put their messages on the stan- 
dard output. Hence, both error sources should be piped together into error. For example, when using the 
csh syntax, 


make -s lint | & error -q -V 
will analyze all the error messages produced by whatever programs make runs when making lint. 


Error knows about the error messages produced by: make, cc, cpp, ccom, as, Id, lint, pi, pc, f77, and DEC 
Western Research Modula-2. Error knows a standard format for error messages produced by the language 
processors, so is sensitive to changes in these formats. For all languages except Pascal, error messages are 
restricted to be on one line. Some error messages refer to more than one line in more than one files; error 
will duplicate the error message and insert it at all of the places referenced. 


Error will do one of six things with error messages. 


synchronize 
Some language processors produce short errors describing which file it is processing. Error 
uses these to determine the file name for languages that don’t include the file name in each 
error message. These synchronization messages are consumed entirely by error. 


discard Error messages from lint that refer to one of the two Jint libraries, /usr/lib/lib-lc and 
/usrNib/llib-port are discarded, to prevent accidently touching these libraries. Again, these 
error messages are consumed entirely by error. 


nullify Error messages from lint can be nullified if they refer to a specific function, which is known to 
generate diagnostics which are not interesting. Nullified error messages are not inserted into 
the source file, but are written to the standard output. The names of functions to ignore are 
taken from either the file named .errorrc in the users’s home directory, or from the file named 
by the -I option. If the file does not exist, no error messages are nullified. If the file does 
exist, there must be one function name per line. 


not file specific 
Error messages that can’t be intuited are grouped together, and written to the standard output 
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before any files are touched. They will not be inserted into any source file. 


le specific Error message that refer to a specific file, but to no specific line, are written to the standard out- 
iP g 19) 19) 
put when that file is touched. 


true errors Error messages that can be intuited are candidates for insertion into the file to which they refer. 


Only true error messages are candidates for inserting into the file they refer to. Other error messages are 
consumed entirely by error or are written to the standard output. Error inserts the error messages into the 
source file on the line preceding the line the language processor found in error. Each error message is 
turned into a one line comment for the language, and is internally flagged with the string “‘###’ at the 
beginning of the error, and ‘‘%%%’’ at the end of the error. This makes pattern searching for errors easier 
with an editor, and allows the messages to be easily removed. In addition, each error message contains the 
source line number for the line the message refers to. A reasonably formatted source program can be 
recompiled with the error messages still in it, without having the error messages themselves cause future 
errors. For poorly formatted source programs in free format languages, such as C or Pascal, it is possible to 
insert a comment into another comment, which can wreak havoc with a future compilation. To avoid this, 
programs with comments and source on the same line should be formatted so that language statements 
appear before comments. 


Options available with error are: 


-n  Dovnot touch any files; all error messages are sent to the standard output. 


665799 6699 


-q The user is queried whether s/he wants to touch the file. A ‘‘y’’ or ‘‘n’’ to the question is necessary 
to continue. Absence of the -q option implies that all referenced files (except those referring to dis- 
carded error messages) are to be touched. 


-v_ After all files have been touched, overlay the visual editor vi with it set up to edit all files touched, 
and positioned in the first touched file at the first error. If vi can’t be found, try ex or ed from stan- 
dard places. 


-t = Take the following argument as a suffix list. Files whose suffixes do not appear in the suffix list are 
not touched. The suffix list is dot separated, and ‘**’’ wildcards work. Thus the suffix list: 
"\c.y.foo*.h" 
allows error to touch files ending with ‘‘.c’’, ‘‘.y’’, “*.foo®’’ and ‘‘.y’’. 
-s Print out statistics regarding the error categorization. Not too useful. 


Error catches interrupt and terminate signals, and if in the insertion phase, will orderly terminate what it is 
doing. 


AUTHOR 
Robert Henry 

FILES 
“/.errorre function names to ignore for lint error messages 
/dev/tty user’s teletype 

BUGS 


Opens the teletype directly to do user querying. 
Source files with links make a new copy of the file with only one link to it. 


Changing a language processor’s format of error messages may cause error to not understand the error 
message. 


Error, since it is purely mechanical, will not filter out subsequent errors caused by “floodgating’ initiated by 
one syntactically trivial error. Humans are still much better at discarding these related errors. 
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Pascal error messages belong after the lines affected (error puts them before). The alignment of the ‘ [F 
marking the point of error is also disturbed by error. 


Error was designed for work on CRT’s at reasonably high speed. It is less pleasant on slow speed termi- 
nals, and has never been used on hardcopy terminals. 
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NAME 
ex, edit — text editor 

SYNOPSIS 
ex [-] [-v ] [-t tag ] [-r] [ tcommand ][-1] name... 
edit [ ex options ] 

DESCRIPTION 
Ex is the root of a family of editors: edit, ex and vi. Ex is a superset of ed, with the most notable extension 
being a display editing facility. Display based editing is the focus of vi. 
If you have not used ed, or are a casual user, you will find that the editor edit is convenient for you. It 
avoids some of the complexities of ex used mostly by systems programmers and persons very familiar with 
ed. 
If you have a CRT terminal, you may wish to use a display based editor; in this case see vi(1), which is a 
command which focuses on the display editing portion of ex. 

DOCUMENTATION 
The document Edit: A tutorial (USD:14) provides a comprehensive introduction to edit assuming no previ- 
ous knowledge of computers or the UNIX system. 
The Ex Reference Manual — Version 3.7 (USD:16) is a comprehensive and complete manual for the com- 
mand mode features of ex, but you cannot learn to use the editor by reading it. For an introduction to more 
advanced forms of editing using the command mode of ex see the editing documents written by Brian Ker- 
nighan for the editor ed; the material in the introductory and advanced documents works also with ex. 
An Introduction to Display Editing with Vi (USD:15) introduces the display editor vi and provides reference 
material on vi. In addition, the Vi Quick Reference card summarizes the commands of vi in a useful, func- 
tional way, and is useful with the Introduction. 

FILES 
/usr/lib/ex?.?strings error messages 
/ust/lib/ex?.?recover recover command 
/usr/lib/ex?.? preserve preserve command 
/etc/termcap describes capabilities of terminals 
“/.exrc editor startup file 
/tmp/Exnannn editor temporary 
/tmp/Rxnnnnn named buffer temporary 
/ustr/preserve preservation directory 

SEE ALSO 
awk(1), ed(1), grep(1), sed(1), grep(1), vi(1), termcap(5), environ(7) 

AUTHOR 
Originally written by William Joy 
Mark Horton has maintained the editor since version 2.7, adding macros, support for many unusual termi- 
nals, and other features such as word abbreviation mode. 

BUGS 


The undo command causes all marks to be lost on lines changed and then restored if the marked lines were 
changed. 


Undo never clears the buffer modified condition. 


The z command prints a number of logical rather than physical lines. More than a screen full of output may 
result if long lines are present. 


File input/output errors don’t print a name if the command line ‘—’ option is used. 
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There is no easy way to do a single scan ignoring case. 
The editor does not warn if text is placed in named buffers and not used before exiting the editor. 


Null characters are discarded in input files, and cannot appear in resultant files. 
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NAME 
expand, unexpand — expand tabs to spaces, and vice versa 


SYNOPSIS 
expand [ —tabstop ] [ -tab1,tab2,...,tabn ] [ file... ] 
unexpand [ —a ] [ file... ] 


DESCRIPTION 
Expand processes the named files or the standard input writing the standard output with tabs changed into 
blanks. Backspace characters are preserved into the output and decrement the column count for tab calcula- 
tions. Expand is useful for pre-processing character files (before sorting, looking at specific columns, etc.) 
that contain tabs. 


If a single tabstop argument is given, then tabs are set tabstop spaces apart instead of the default 8. If mul- 
tiple tabstops are given then the tabs are set at those specific columns. 


Unexpand puts tabs back into the data from the standard input or the named files and writes the result on 
the standard output. By default, only leading blanks and tabs are reconverted to maximal strings of tabs. If 
the —a option is given, then tabs are inserted whenever they would compress the resultant file by replacing 
two or more characters. 
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NAME 
expr — evaluate arguments as an expression 
SYNOPSIS 
expr arg... 
DESCRIPTION 
The arguments are taken as an expression. After evaluation, the result is written on the standard output. 
Each token of the expression is a separate argument. 
The operators and keywords are listed below. The list is in order of increasing precedence, with equal 
precedence operators grouped. 
expr | expr 
yields the first expr if it is neither null nor ‘0’, otherwise yields the second expr. 
expr & expr 
yields the first expr if neither expr is null or ‘0’, otherwise yields ‘0’. 
expr relop expr 
where relop is one of < <= = != >= >, yields ‘1’ if the indicated comparison is true, ‘0’ if false. 
The comparison is numeric if both expr are integers, otherwise lexicographic. 
expr + expr 
expr — expr 
addition or subtraction of the arguments. 
expr * expr 
expr / expr 
expr % expr 
multiplication, division, or remainder of the arguments. 
expr : expr 
The matching operator compares the string first argument with the regular expression second argu- 
ment; regular expression syntax is the same as that of ed(1). The \(...\) pattern symbols can be 
used to select a portion of the first argument. Otherwise, the matching operator yields the number 
of characters matched (‘0’ on failure). 
(expr ) parentheses for grouping. 
Examples: 
To add 1 to the Shell variable a: 
a= expr $a + 1° 
To find the filename part (least significant part) of the pathname stored in variable a, which may or may not 
contain ‘/’: 
expr $a: *.*/A(.*\)’ “|* $a 
Note the quoted Shell metacharacters. 
SEE ALSO 
sh(1), test(1) 
DIAGNOSTICS 
Expr returns the following exit codes: 
0 if the expression is neither null nor ‘0’, 
1 if the expression is null or ‘0’, 
2 for invalid expressions. 
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{77 — Fortran 77 compiler 


SYNOPSIS 


£77 [ option ] ... file ... 


DESCRIPTION 


F77 is the UNIX Fortran 77 compiler. It accepts several types of arguments: 


Arguments whose names end with ‘.f are taken to be Fortran 77 source programs; they are compiled, and 
each object program is left on the file in the current directory whose name is that of the source with ‘.o’ 
substituted for ’.f’. 


Arguments whose names end with ‘.F’ are also taken to be Fortran 77 source programs; these are first pro- 
cessed by the C preprocessor before being compiled by f77. 


Arguments whose names end with ‘1’ or ‘.e’ are taken to be Ratfor or EFL source programs respectively; 
these are first transformed by the appropriate preprocessor, then compiled by {77. 


Arguments whose names end with ‘.c’ or ‘.s’ are taken to be C or assembly source programs and are com- 
piled or assembled, producing a ‘.o’ file. 


The following options have the same meaning as in cc(1). See /d(1) for load-time options. 
—c Suppress loading and produce *.o’ files for each source file. 


-g Produce additional symbol table information for dbx(1) and pass the -lg flag to /d(1) so that on 
abnormal terminations, the memory image is written to file core. Incompatible with -O. 


—0 output 
Name the final output file output instead of ‘a.out’. 


-p Prepare object files for profiling, see prof(1). 


—pg Causes the compiler to produce counting code in the manner of —p, but invokes a run-time record- 
ing mechanism that keeps more extensive statistics and produces a gmon.out file at normal termi- 
nation. An execution profile can then be generated by use of gprof(1). 


‘ 


-w Suppress all warning messages. If the option is 
are suppressed. 


—Dname=def 


—w66’, only Fortran 66 compatibility warnings 


—Dname 
Define the name to the C preprocessor, as if by ‘#define’. If no definition is given, the name is 
defined as "1". (‘.F’ suffix files only). 


-Idir ‘‘#include’ files whose names do not begin with ‘/’ are always sought first in the directory of the 
file argument, then in directories named in —I options, then in directories on a standard list. (‘.F’ 
suffix files only). 


-O Invoke an object-code optimizer. Incompatible with —g. 


-S Compile the named programs, and leave the assembler-language output on corresponding files 
suffixed ‘.s’. (No ‘.o’ is created.). 


The following options are peculiar to f77. 
-d Used for debugging the compiler. 


-i2 On machines which support short integers, make the default integer constants and variables short. 
(-i4 is the standard value of this option). All logical quantities will be short. 


-q Suppress printing of file names and program unit names during compilation. 
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—m Apply the M4 preprocessor to each ‘.r’ file before transforming it with the Ratfor or EFL prepro- 
cessor. 


—onetrip 


-1 Compile DO loops that are performed at least once if reached. (Fortran 77 DO loops are not per- 
formed at all if the upper limit is smaller than the lower limit.) 


-r8 Treat all floating point variables, constants, functions and intrinsics as double precision and all 
complex quantities as double complex. 


-u Make the default type of a variable ‘undefined’ rather than using the default Fortran rules. 
-v Print the version number of the compiler, and the name of each pass as it executes. 
-C Compile code to check that subscripts are within declared array bounds. For multi-dimensional 


arrays, only the equivalent linear subscript is checked. 


-F Apply the C preprocessor to ‘.F’ files, and the EFL, or Ratfor preprocessors to ‘.e’ and ‘.r’ files, 
put the result in the file with the suffix changed to ‘.f’, but do not compile. 


-Ex Use the string x as an EFL option in processing ‘.e’ files. 
-Rx Use the string x as a Ratfor option in processing ‘.r’ files. 
-N[qxsen]nnn 


Make static tables in the compiler bigger. The compiler will complain if it overflows its tables and 
suggest you apply one or more of these flags. These flags have the following meanings: 


q Maximum number of equivalenced variables. Default is 150. 


x Maximum number of external names (common block names, subroutine and function 
names). Default is 200. 


s Maximum number of statement numbers. Default is 401. 
c Maximum depth of nesting for control statements (e.g. DO loops). Default is 20. 
n Maximum number of identifiers. Default is 1009. 
—U Do not convert upper case letters to lower case. The default is to convert Fortran programs to 


lower case except within character string constants. 


Other arguments are taken to be either loader option arguments, or F77-compatible object programs, typi- 
cally produced by an earlier run, or perhaps libraries of F77-compatible routines. These programs, together 
with the results of any compilations specified, are loaded (in the order given) to produce an executable pro- 
gram with name ‘a.out’. 


Programs compiled with f77 produce memory dumps in file core upon abnormal termination if the —g flag 
was specified during loading. If the environment variable f77_dump_flag is set to a value beginning with y 
orn, dumps for abnormal terminations are respectively forced or suppressed. 


file.[fFresc] input file 

file.o object file 

a.out loaded output 
/usr/lib/f77pass1 compiler 

/Nib/f1 pass 2 

Nib/c2 optional optimizer 
/ib/cpp C preprocessor 


/usr/lib/libF77.a intrinsic function library 
/usr/lib/libI77.a Fortran I/O library 
/usr/lib/ibU77.a = UNIX interface library 
/usr/lib/libm.a math library 
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Nib/libc.a C library, see section 3 
/usr/lib/libF77_ p.a_ profiling intrinsic function library 
/usr/lib/libI77_p.a__ profiling Fortran I/O library 
/usr/lib/libU77_p.a_ profiling UNIX interface library 
/usr/lib/libm_p.a __ profiling math library 
/asr/lib/libc_p.a profiling C library, see section 3 


mon.out file produced for analysis by prof(1). 
gmon.out file produced for analysis by gprof(1). 
SEE ALSO 


S. I. Feldman, P. J. Weinberger, J. Berkman, A Portable Fortran 77 Compiler 
D. L. Wasley, J. Berkman, Introduction to the f77 I/O Library 

fpr(1), fsplit(1), 1d(1), ar(1), ranlib(1), dbx(1), intro(3f) 

efl(1), ratfor(1), struct(1), prof(1), gprof(1), cc(1) 


DIAGNOSTICS 
The diagnostics produced by f77 itself are intended to be self-explanatory. Occasional messages may be 
produced by the loader. 

BUGS 


Files longer than about 50,000 lines must be split up to be compiled. 
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NAME 
false, true — provide truth values 


SYNOPSIS 
true 


false 


DESCRIPTION 
True and false are usually used in a Bourne shell script. They test for the appropriate status "true" or 
"false" before running (or failing to run) a list of commands. 


EXAMPLE 
while false 
do 
command list 
done 
SEE ALSO 
csh(1), sh(1), true(1) 
DIAGNOSTICS 


False has exit status nonzero. 
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NAME 
file — determine file type 


SYNOPSIS 
file file ... 


DESCRIPTION 
File performs a series of tests on each argument in an attempt to classify it. If an argument appears to be 
ascii, file examines the first 512 bytes and tries to guess its language. 


BUGS 
It often makes mistakes. In particular it often suggests that command files are C programs. 


Does not recognize Pascal or LISP. 
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NAME 


find — find files 


SYNOPSIS 


find pathname-list expression 
find pattern 


DESCRIPTION 


In the first form above, find recursively descends the directory hierarchy for each pathname in the 
pathname-list (i.e., one or more pathnames) seeking files that match a boolean expression written in the pri- 
maries given below. In the descriptions, the argument 7 is used as a decimal integer where +n means more 
than n, —1 means less than n and n means exactly n. 


The second form rapidly searches a database for all pathnames which match pattern. Usually the database 
is recomputed weekly and contains the pathnames of all files which are publicly accessible. If escaped, 
normal shell ‘‘globbing’’ characters (‘*’, ‘?’, ‘[’, and ’]’) may be used in pattern, but the matching differs 
in that no characters (e.g. ‘/’) have to be matched explicitly. As a special case, a simple pattern containing 
no globbing characters is matched as though it were *pattern*; if any globbing character appears there are 
no implicit globbing characters. 


—name filename 
True if the filename argument matches the current file name. Normal shell argument syntax 
may be used if escaped (watch out for ‘[’, ‘?’ and ‘*’). 


—perm onum 
True if the file permission flags exactly match the octal number onum (see chmod(1)). If onum 
is prefixed by a minus sign, more flag bits (017777, see stat(2)) become significant and the 
flags are compared: (flags&onum)==onum. 


—type c True if the type of the file is c, where c is b, c, d, f, 1 or s for block special file, character special 
file, directory, plain file, symbolic link, or socket. 


-links n True if the file has n links. 


—user uname 
True if the file belongs to the user uname (login name or numeric user ID). 


-nouser True if the file belongs to a user not in the /etc/passwd database. 


—group gname 
True if the file belongs to group gname (group name or numeric group ID). 


—nogroup True if the file belongs to a group not in the /etc/group database. 
-size n True if the file is n blocks long (512 bytes per block). 

-inumn_ ‘True if the file has inode number n. 

-atimen True if the file has been accessed in n days. 

-mtimen_ True if the file has been modified in n days. 


—exec command 
True if the executed command returns a zero value as exit status. The end of the command 
must be punctuated by an escaped semicolon. A command argument ‘{}’ is replaced by the 
current pathname. 


—ok command 
Like —-exec except that the generated command is written on the standard output, then the stan- 
dard input is read and the command executed only upon response y. 


—print Always true; causes the current pathname to be printed. 
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—newer file 
-cpio file 


—xdev 
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Always true; causes current pathname to be printed together with its associated statistics. 
These include (respectively) inode number, size in kilobytes (1024 bytes), protection mode, 
number of hard links, user, group, size in bytes, and modification time. If the file is a special 
file the size field will instead contain the major and minor device numbers. If the file is a sym- 
bolic link the pathname of the linked-to file is printed preceded by ‘*->’’. The format is identi- 
cal to that of “‘ls -gilds’’ (note however that formatting is done internally, without executing 
the ls program). 


True if the current file has been modified more recently than the argument file. 
Write the current file on the argument file in cpio format. 


Always true; causes find not to traverse down into a file system different from the one on 
which current argument pathname resides. 


The primaries may be combined using the following operators (in order of decreasing precedence): 


1) A parenthesized group of primaries and operators (parentheses are special to the Shell and must be 
escaped). 


2) The negation of a primary (‘!’ is the unary not operator). 


3) Concatenation of primaries (the and operation is implied by the juxtaposition of two primaries). 


4)  Alternation of primaries (‘—o’ is the or operator). 


EXAMPLES 


To find all accessible files whose pathname contains ‘find’: 


find find 


To typeset all variants of manual pages for ‘Is’: 


vtroff -man ‘find ’*man*/ls.?’‘ 


To remove all files named ‘a.out’ or ‘*.0’ that have not been accessed for a week: 


find / \(—name a.out —o —name **.0’ \) —atime +7 -exec rm {} \; 


FILES 
/etc/passwd 
/etc/group 


/usr/lib/find/find.codes coded pathnames database 


SEE ALSO 


sh(1), test(1), fs(5) 
Relevant paper in February, 1983 issue of ;login:. 


BUGS 


The first form’s syntax is painful, and the second form’s exact semantics is confusing and can vary from 


site to site. 


More than one ‘-newer’ option does not work properly. 
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NAME 
finger — user information lookup program 


SYNOPSIS 
finger [ options ] name ... 


DESCRIPTION 
By default finger lists the login name, full name, terminal name and write status (as a ‘*’ before the termi- 
nal name if write permission is denied), idle time, login time, and office location and phone number (if they 
are known) for each current UNIX user. (Idle time is minutes if it is a single integer, hours and minutes if a 
*Y is present, or days and hours if a ’d’ is present.) 


A longer format also exists and is used by finger whenever a list of people’s names is given. (Account 
names as well as first and last names of users are accepted.) This format is multi-line, and includes all the 
information described above as well as the user’s home directory and login shell, any plan which the person 
has placed in the file .plan in their home directory, and the project on which they are working from the file 
-project also in the home directory. 


Finger may be used to lookup users on a remote machine. The format is to specify the user as 
“‘user@host.’’ If the user name is left off, the standard format listing is provided on the remote machine. 


Finger options include: 
—m Match arguments only on user name. 
| Force long output format. 


—p Suppress printing of the .plan files 


-Ss Force short output format. 

FILES 
/etc/utmp who file 
/etc/passwd for users names, offices, ... 
/usr/adm/lastlog last login times 
/.plan plans 
“/.project projects 

SEE ALSO 
chfn(1), w(1), who(1) 

AUTHOR 
Earl T. Cohen 

BUGS 


Only the first line of the .project file is printed. 


The encoding of the gcos field is UCB dependent — it knows that an office ‘197MC’ is ‘197M Cory Hall’, 
and that ‘529BE’ is ‘529B Evans Hall’. It also knows that a four digit office phone number should have a 
“*x2-’’ prepended. 


There is no way to pass arguments to the remote machine as finger uses an internet standard port. 


A user information data base is in the works and will radically alter the way the information that finger uses 
is stored. Finger will require extensive modification when this is implemented. 
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NAME 
fmt — simple text formatter 
SYNOPSIS 
fmt [ name... ] 
DESCRIPTION 
Fmt is a simple text formatter which reads the concatenation of input files (or standard input if none are 
given) and produces on standard output a version of its input with lines as close to 72 characters long as 
possible. The spacing at the beginning of the input lines is preserved in the output, as are blank lines and 
interword spacing. 
Fmt is meant to format mail messages prior to sending, but may also be useful for other simple tasks. For 
instance, within visual mode of the ex editor (e.g. vi) the command 
'\fmt 
will reformat a paragraph, evening the lines. 
SEE ALSO 
nroff(1), mail(1) 
AUTHOR 
Kurt Shoens 
BUGS 


The program was designed to be simple and fast — for more complex operations, the standard text proces- 
sors are likely to be more appropriate. 
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NAME 

fold — fold long lines for finite width output device 
SYNOPSIS 

fold [ —width ] [ file... ] 
DESCRIPTION 


Fold is a filter which will fold the contents of the specified files, or the standard input if no files are 
specified, breaking the lines to have maximum width width. The default for width is 80. Width should be a 
multiple of 8 if tabs are present, or the tabs should be expanded using expand(1) before coming to fold. 


SEE ALSO 
expand(1) 


BUGS 
If underlining is present it may be messed up by folding. 
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NAME 
fp — Functional Programming language compiler/interpreter 


SYNOPSIS 
fp 
DESCRIPTION 


Fp is an interpreter/compiler that implements the applicative language proposed by John Backus. It is writ- 
ten in FRANZ LISP. 


In a functional programming language intent is expressed in a mathematical style devoid of assignment 
statements and variables. Functions compute by value only; there are no side-effects since the result of a 
computation depends solely on the inputs. 


Fp "programs" consist of functional expressions — primitive and user-defined fp functions combined by 
functional forms. These forms take functional arguments and return functional results. For example, the 
composition operator ’@’ takes two functional arguments and returns a function which represents their 
composition. 


There exists a single operation in fp — application. This operation causes the system to evaluate the indi- 
cated function using the single argument as input (all functions are monadic). 


GETTING STARTED 
Fp invokes the system. Fp compiles functions into /isp(1) source code; lisp(1) interprets this code (the user 
may compile this code using the liszt (1) compiler to gain a factor of 10 in performance). Control D exits 
back to the shell. Break terminates any computation in progress and resets any open file units. )help pro- 
vides a short summary of all user commands. 


FILES 
/usr/ucb/lisp the FRANZ LISP interpreter 
/usr/ucb/liszt the liszt compiler 
/usr/doc/fp the User’s Guide 
SEE ALSO 
lisp(1), liszt(1). 
The Berkeley FP user’s manual, available on-line. The language is described in the August 1978 issue of 
CACM (Turing award lecture by John Backus). 
BUGS 


If a non-terminating function is applied as the result of loading a file, then control is returned to the user 
immediately, everything after that position in the file is ignored. 


FP incorrectly marks the location of a syntax error on large, multi-line function definitions or applications. 


AUTHOR 
Scott B. Baden 
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NAME 

fpr — print Fortran file 
SYNOPSIS 

fpr 
DESCRIPTION 


Fpr is a filter that transforms files formatted according to Fortran’s carriage control conventions into files 
formatted according to UNIX line printer conventions. 


Fpr copies its input onto its output, replacing the carriage control characters with characters that will pro- 
duce the intended effects when printed using /pr(1). The first character of each line determines the vertical 
spacing as follows: 


Character | Vertical Space Before Printing 
Blank One line 


0 Two lines 
1 To first line of next page 
+ No advance 


A blank line is treated as if its first character is a blank. A blank that appears as a carriage control character 
is deleted. A zero is changed to a newline. A one is changed to a form feed. The effects of a "+" are simu- 
lated using backspaces. 


EXAMPLES 
a.out | fpr | Ipr 


fpr < f77.output | Ipr 


BUGS 
Results are undefined for input lines longer than 170 characters. 
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NAME 
from — who is my mail from? 


SYNOPSIS 
from [ -s sender ] [ user ] 


DESCRIPTION 
From prints out the mail header lines in your mailbox file to show you who your mail is from. If user is 
specified, then user’s mailbox is examined instead of your own. If the -s option is given, then only headers 
for mail sent by sender are printed. 


FILES 
/ust/spool/mail/* 


SEE ALSO 
biff(1), mail(1) 
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NAME 
fsplit — split a multi-routine Fortran file into individual files 

SYNOPSIS 
fsplit [ -e efile] ... [ file ] 

DESCRIPTION 
Fsplit takes as input either a file or standard input containing Fortran source code. It attempts to split the 
input into separate routine files of the form name.f, where name is the name of the program unit (e.g. func- 
tion, subroutine, block data or program). The name for unnamed block data subprograms has the form 
blkdtaNNN.f where NNN is three digits and a file of this name does not already exist. For unnamed main 
programs the name has the form mainNNN.f. If there is an error in classifying a program unit, or if namef 
already exists, the program unit will be put in a file of the form zzzNNN.f where zzzNNN.f does not already 
exist. 
Normally each subprogram unit is split into a separate file. When the -e option is used, only the specified 
subprogram units are split into separate files. E.g.: 

fsplit -e readit -e doit prog.f 

will split readit and doit into separate files. 

DIAGNOSTICS 
If names specified via the -e option are not found, a diagnostic is written to standard error. 

AUTHOR 
Asa Romberger and Jerry Berkman 

BUGS 


F split assumes the subprogram name is on the first noncomment line of the subprogram unit. Nonstandard 
source formats may confuse fsplit. 


It is hard to use -e for unnamed main programs and block data subprograms since you must predict the cre- 
ated file name. 
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NAME 


ftp - ARPANET file transfer program 


SYNOPSIS 


ftp [-v ][-d][-i][-n][-g] [ host ] 


DESCRIPTION 


Ftp is the user interface to the ARPANET standard File Transfer Protocol. The program allows a user to 
transfer files to and from a remote network site. 


The client host with which ftp is to communicate may be specified on the command line. If this is done, ftp 
will immediately attempt to establish a connection to an FTP server on that host; otherwise, ftp will enter its 
command interpreter and await instructions from the user. When ftp is awaiting commands from the user 
the prompt “‘ftp>’’ is provided to the user. The following commands are recognized by fip: 


! | command [ args ] | 
Invoke an interactive shell on the local machine. If there are arguments, the first is taken to be a 
command to execute directly, with the rest of the arguments as its arguments. 


$ macro-name [ args | 
Execute the macro macro-name that was defined with the macdef command. Arguments are 
passed to the macro unglobbed. 


account [ passwd | 
Supply a supplemental password required by a remote system for access to resources once a login 
has been successfully completed. If no argument is included, the user will be prompted for an 
account password in a non-echoing input mode. 


append local-file [ remote-file | 
Append a local file to a file on the remote machine. If remote-file is left unspecified, the local file 
name is used in naming the remote file after being altered by any ntrans or nmap setting. File 
transfer uses the current settings for type, format, mode, and structure. 


ascii _ Set the file transfer type to network ASCII. This is the default type. 
bell Arrange that a bell be sounded after each file transfer command is completed. 
binary Set the file transfer type to support binary image transfer. 


bye Terminate the FTP session with the remote server and exit ftp. An end of file will also terminate 
the session and exit. 


case Toggle remote computer file name case mapping during mget commands. When case is on 
(default is off), remote computer file names with all letters in upper case are written in the local 
directory with the letters mapped to lower case. 


ed remote-directory 
Change the working directory on the remote machine to remote-directory. 


cdup Change the remote machine working directory to the parent of the current remote machine work- 
ing directory. 


close Terminate the FTP session with the remote server, and return to the command interpreter. Any 
defined macros are erased. 


cr Toggle carriage return stripping during ascii type file retrieval. Records are denoted by a carriage 
return/linefeed sequence during ascii type file transfer. When cr is on (the default), carriage 
returns are stripped from this sequence to conform with the UNIX single linefeed record delimiter. 
Records on non-UNIX remote systems may contain single linefeeds; when an ascii type transfer is 
made, these linefeeds may be distinguished from a record delimiter only when er is off. 


delete remote-file 
Delete the file remote-file on the remote machine. 
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debug [ debug-value | 
Toggle debugging mode. If an optional debug-value is specified it is used to set the debugging 
level. When debugging is on, ftp prints each command sent to the remote machine, preceded by 
the string ‘‘-->’’. 


dir [ remote-directory | [ local-file | 
Print a listing of the directory contents in the directory, remote-directory, and, optionally, placing 
the output in Jocal-file. If no directory is specified, the current working directory on the remote 
machine is used. If no local file is specified, or local-file is -, output comes to the terminal. 


disconnect 
A synonym for close. 


form format 
Set the file transfer form to format. The default format is ‘‘file’’. 


get remote-file | local-file | 
Retrieve the remote-file and store it on the local machine. If the local file name is not specified, it 
is given the same name it has on the remote machine, subject to alteration by the current case, 
ntrans, and nmap settings. The current settings for type, form, mode, and structure are used while 
transferring the file. 


glob Toggle filename expansion for mdelete, mget and mput. If globbing is turned off with glob, the 
file name arguments are taken literally and not expanded. Globbing for mput is done as in esh(1). 
For mdelete and mget, each remote file name is expanded separately on the remote machine and 
the lists are not merged. Expansion of a directory name is likely to be different from expansion of 
the name of an ordinary file: the exact result depends on the foreign operating system and ftp 
server, and can be previewed by doing ‘mls remote-files -’. Note: mget and mput are not meant 
to transfer entire directory subtrees of files. That can be done by transferring a tar(1) archive of 
the subtree (in binary mode). 


hash Toggle hash-sign (‘‘#’’) printing for each data block transferred. The size of a data block is 1024 
bytes. 


help [ command | 
Print an informative message about the meaning of command. If no argument is given, ftp prints a 
list of the known commands. 


Icd [ directory | 
Change the working directory on the local machine. If no directory is specified, the user’s home 
directory is used. 


Is [ remote-directory | { local-file | 
Print an abbreviated listing of the contents of a directory on the remote machine. If remote- 
directory is left unspecified, the current working directory is used. If no local file is specified, or if 
local-file is -, the output is sent to the terminal. 


macdef macro-name 

Define a macro. Subsequent lines are stored as the macro macro-name; a null line (consecutive 
newline characters in a file or carriage returns from the terminal) terminates macro input mode. 
There is a limit of 16 macros and 4096 total characters in all defined macros. Macros remain 
defined until a close command is executed. The macro processor interprets ’$’ and ’\’ as special 
characters. A ’$’ followed by a number (or numbers) is replaced by the corresponding argument 
on the macro invocation command line. A ’$’ followed by an ’i’ signals that macro processor that 
the executing macro is to be looped. On the first pass ’$i’ is replaced by the first argument on the 
macro invocation command line, on the second pass it is replaced by the second argument, and so 
on. A ’\ followed by any character is replaced by that character. Use the ’V to prevent special 
treatment of the ’$’. 
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mdelete [ remote-files | 
Delete the remote-files on the remote machine. 


mdir remote-files local-file 
Like dir, except multiple remote files may be specified. If interactive prompting is on, ftp will 
prompt the user to verify that the last argument is indeed the target local file for receiving mdir 
output. 


mget remote-files 
Expand the remote-files on the remote machine and do a get for each file name thus produced. See 
glob for details on the filename expansion. Resulting file names will then be processed according 
to case, ntrans, and nmap settings. Files are transferred into the local working directory, which 
can be changed with ‘Ied directory’; new local directories can be created with ‘! mkdir directory’. 


mkdir directory-name 
Make a directory on the remote machine. 


mls remote-files local-file 
Like Is, except multiple remote files may be specified. If interactive prompting is on, ftp will 
prompt the user to verify that the last argument is indeed the target local file for receiving mls out- 
put. 


mode [ mode-name | 
Set the file transfer mode to mode-name. The default mode is ‘‘stream’’ mode. 


mput local-files 
Expand wild cards in the list of local files given as arguments and do a put for each file in the 
resulting list. See glob for details of filename expansion. Resulting file names will then be pro- 
cessed according to ntrans and nmap settings. 


nmap [ inpattern outpattern | 

Set or unset the filename mapping mechanism. If no arguments are specified, the filename map- 
ping mechanism is unset. If arguments are specified, remote filenames are mapped during mput 
commands and put commands issued without a specified remote target filename. If arguments are 
specified, local filenames are mapped during mget commands and get commands issued without a 
specified local target filename. This command is useful when connecting to a non-UNIX remote 
computer with different file naming conventions or practices. The mapping follows the pattern set 
by inpattern and outpattern. Inpattern is a template for incoming filenames (which may have 
already been processed according to the ntrans and case settings). Variable templating is accom- 
plished by including the sequences ’$1’, ’$2’, ..., °$9° in inpattern. Use ’\’ to prevent this special 
treatment of the ’$’ character. All other characters are treated literally, and are used to determine 
the nmap inpattern variable values. For exmaple, given inpattern $1.$2 and the remote file name 
"mydata.data", $1 would have the value "mydata", and $2 would have the value "data". The out- 
pattern determines the resulting mapped filename. The sequences ’$1’, $2’, ...., °$9’ are replaced 
by any value resulting from the inpattern template. The sequence ’$0’ is replace by the original 
filename. Additionally, the sequence ’[seg/,seq2]’ is replaced by seg! if seq/ is not a null string; 
otherwise it is replaced by seqg2. For example, the command "nmap $1.$2.$3 [$1,$2].[$2,file]" 
would yield the output filename "myfile.data" for input filenames "myfile.data" and 
"myfile.data.old", "myfile.file" for the input filename "myfile", and "myfile.myfile" for the input 
filename ".myfile". Spaces may be included in outpattern, as in the example: nmap $1 |sed "s/ 
*$//" > $1. Use the ’V character to prevent special treatment of the ’$’, ’[’, ’]’, and ’,’ characters. 


ntrans [ inchars [ outchars | | 
Set or unset the filename character translation mechanism. If no arguments are specified, the 
filename character translation mechanism is unset. If arguments are specified, characters in remote 
filenames are translated during mput commands and put commands issued without a specified 
remote target filename. If arguments are specified, characters in local filenames are translated 
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during mget commands and get commands issued without a specified local target filename. This 
command is useful when connecting to a non-UNIX remote computer with different file naming 
conventions or practices. Characters in a filename matching a character in inchars are replaced 
with the corresponding character in outchars. If the character’s position in inchars is longer than 
the length of outchars, the character is deleted from the file name. 


open host [ port | 
Establish a connection to the specified host FTP server. An optional port number may be supplied, 
in which case, ftp will attempt to contact an FTP server at that port. If the auto-login option is on 
(default), ftp will also attempt to automatically log the user in to the FTP server (see below). 


prompt Toggle interactive prompting. Interactive prompting occurs during multiple file transfers to allow 
the user to selectively retrieve or store files. If prompting is turned off (default is on), any mget or 
mput will transfer all files, and any mdelete will delete all files. 


proxy ftp-command 

Execute an ftp command on a secondary control connection. This command allows simultaneous 
connection to two remote ftp servers for transferring files between the two servers. The first proxy 
command should be an open, to establish the secondary control connection. Enter the command 
"proxy ?" to see other ftp commands executable on the secondary connection. The following com- 
mands behave differently when prefaced by proxy: open will not define new macros during the 
auto-login process, close will not erase existing macro definitions, get and mget transfer files from 
the host on the primary control connection to the host on the secondary control connection, and 
put, mput, and append transfer files from the host on the secondary control connection to the host 
on the primary control connection. Third party file transfers depend upon support of the ftp proto- 
col PASV command by the server on the secondary control connection. 


put local-file | remote-file | 
Store a local file on the remote machine. If remote-file is left unspecified, the local file name is 
used after processing according to any ntrans or nmap settings in naming the remote file. File 
transfer uses the current settings for type, format, mode, and structure. 


pwd Print the name of the current working directory on the remote machine. 
quit A synonym for bye. 


quote arg! arg2... 
The arguments specified are sent, verbatim, to the remote FTP server. 


recv remote-file [| local-file | 
A synonym for get. 


remotehelp [ command-name | 
Request help from the remote FTP server. If a command-name is specified it is supplied to the 
server as well. 


rename [ from | [ to ] 
Rename the file from on the remote machine, to the file fo. 


reset Clear reply queue. This command re-synchronizes command/reply sequencing with the remote ftp 
server. Resynchronization may be neccesary following a violation of the ftp protocol by the 
remote server. 


rmdir directory-name 
Delete a directory on the remote machine. 


runique 
Toggle storing of files on the local system with unique filenames. If a file already exists with a 
name equal to the target local filename for a get or mget command, a ".1" is appended to the 
name. If the resulting name matches another existing file, a ".2" is appended to the original name. 


4.2 Berkeley Distribution April 29, 1985 4 


FTP(1C) UNIX Programmer’s Manual FTP(1C) 


If this process continues up to ".99", an error message is printed, and the transfer does not take 
place. The generated unique filename will be reported. Note that runique will not affect local 
files generated from a shell command (see below). The default value is off. 


send local-file | remote-file | 
A synonym for put. 


sendport 
Toggle the use of PORT commands. By default, ftp will attempt to use a PORT command when 
establishing a connection for each data transfer. The use of PORT commands can prevent delays 
when performing multiple file transfers. If the PORT command fails, ftp will use the default data 
port. When the use of PORT commands is disabled, no attempt will be made to use PORT com- 
mands for each data transfer. This is useful for certain FTP implementations which do ignore 
PORT commands but, incorrectly, indicate they’ ve been accepted. 


status Show the current status of ftp. 


struct [ struct-name | 
Set the file transfer structure to struct-name. By default “‘stream’’ structure is used. 


sunique 
Toggle storing of files on remote machine under unique file names. Remote ftp server must sup- 
port ftp protocol STOU command for successful completion. The remote server will report unique 
name. Default value is off. 


tenex Set the file transfer type to that needed to talk to TENEX machines. 
trace Toggle packet tracing. 


type [ type-name |] 
Set the file transfer type to type-name. If no type is specified, the current type is printed. The 
default type is network ASCII. 


user user-name [ password | [ account | 
Identify yourself to the remote FTP server. If the password is not specified and the server requires 
it, ftp will prompt the user for it (after disabling local echo). If an account field is not specified, 
and the FTP server requires it, the user will be prompted for it. If an account field is specified, an 
account command will be relayed to the remote server after the login sequence is completed if the 
remote server did not require it for logging in. Unless ftp is invoked with ‘‘auto-login’’ disabled, 
this process is done automatically on initial connection to the FTP server. 


verbose Toggle verbose mode. In verbose mode, all responses from the FTP server are displayed to the 
user. In addition, if verbose is on, when a file transfer completes, statistics regarding the efficiency 
of the transfer are reported. By default, verbose is on. 


? [command | 
A synonym for help. 


Command arguments which have embedded spaces may be quoted with quote (") marks. 


ABORTING A FILE TRANSFER 
To abort a file transfer, use the terminal interrupt key (usually Ctrl-C). Sending transfers will be immedi- 
ately halted. Receiving transfers will be halted by sending a ftp protocol ABOR command to the remote 
server, and discarding any further data received. The speed at which this is accomplished depends upon the 
remote server’s support for ABOR processing. If the remote server does not support the ABOR command, 
an "ftp>" prompt will not appear until the remote server has completed sending the requested file. 


The terminal interrupt key sequence will be ignored when ftp has completed any local processing and is 
awaiting a reply from the remote server. A long delay in this mode may result from the ABOR processing 
described above, or from unexpected behavior by the remote server, including violations of the ftp protocol. 
If the delay results from unexpected remote server behavior, the local ftp program must be killed by hand. 
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FILE NAMING CONVENTIONS 
Files specified as arguments to ftp commands are processed according to the following rules. 


1) If the file name ‘‘—’’ is specified, the stdin (for reading) or stdout (for writing) is used. 


2) If the first character of the file name is ‘‘|’’, the remainder of the argument is interpreted as a shell 
command. F7p then forks a shell, using popen(3) with the argument supplied, and reads (writes) 
from the stdout (stdin). If the shell command includes spaces, the argument must be quoted; e.g. 
ong lp AN particularly useful example of this mechanism is: ‘‘dir | more’’. 


3) Failing the above checks, if “‘globbing’’ is enabled, local file names are expanded according to the 
rules used in the csh(1); c.f. the glob command. If the ftp command expects a single local file ( 
.e.g. put), only the first filename generated by the "globbing" operation is used. 


4) For mget commands and get commands with unspecified local file names, the local filename is the 
remote filename, which may be altered by a case, ntrans, or nmap setting. The resulting filename 
may then be altered if runique is on. 


5) For mput commands and put commands with unspecified remote file names, the remote filename 
is the local filename, which may be altered by a ntrans or nmap setting. The resulting filename 
may then be altered by the remote server if sunique is on. 


FILE TRANSFER PARAMETERS 
The FTP specification specifies many parameters which may affect a file transfer. The type may be one of 
‘ascii’, “‘image’’ (binary), ‘‘ebcdic’’, and ‘‘local byte size’’ (for PDP-10’s and PDP-20’s mostly). Ftp 
supports the ascii and image types of file transfer, plus local byte size 8 for tenex mode transfers. 


Ftp supports only the default values for the remaining file transfer parameters: mode, form, and struct. 


OPTIONS 
Options may be specified at the command line, or to the command interpreter. 


The —v (verbose on) option forces ftp to show all responses from the remote server, as well as report on data 
transfer statistics. 


The —n option restrains ftp from attempting ‘‘auto-login’’ upon initial connection. If auto-login is enabled, 
jtp will check the .netrc (see below) file in the user’s home directory for an entry describing an account on 
the remote machine. If no entry exists, ftp will prompt for the remote machine login name (default is the 
user identity on the local machine), and, if necessary, prompt for a password and an account with which to 
login. 


The -i option turns off interactive prompting during multiple file transfers. 
The —d option enables debugging. 
The -g option disables file name globbing. 


THE .netre FILE 
The .netre file contains login and initialization information used by the auto-login process. It resides in the 
user’s home directory. The following tokens are recognized; they may be separated by spaces, tabs, or 
new-lines: 


machine name 
Identify a remote machine name. The auto-login process searches the .netre file for a machine 
token that matches the remote machine specified on the ftp command line or as an open command 
argument. Once a match is made, the subsequent .netrc tokens are processed, stopping when the 
end of file is reached or another machine token is encountered. 


login name 
Identify a user on the remote machine. If this token is present, the auto-login process will initiate 
a login using the specified name. 
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BUGS 


password string 
Supply a password. If this token is present, the auto-login process will supply the specified string 
if the remote server requires a password as part of the login process. Note that if this token is pre- 
sent in the .netre file, ftp will abort the auto-login process if the .netrc is readable by anyone 
besides the user. 


account string 
Supply an additional account password. If this token is present, the auto-login process will supply 
the specified string if the remote server requires an additional account password, or the auto-login 
process will initiate an ACCT command if it does not. 


macdef name 
Define a macro. This token functions like the ftp macdef command functions. A macro is defined 
with the specified name; its contents begin with the next .netrc line and continue until a null line 
(consecutive new-line characters) is encountered. If a macro named init is defined, it is automati- 
cally executed as the last step in the auto-login process. 


Correct execution of many commands depends upon proper behavior by the remote server. 


An error in the treatment of carriage returns in the 4.2BSD UNIX ascii-mode transfer code has been cor- 
rected. This correction may result in incorrect transfers of binary files to and from 4.2BSD servers using 
the ascii type. Avoid this problem by using the binary image type. 
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NAME 
gcore — get core images of running processes 


SYNOPSIS 
gcore process-id ... 


DESCRIPTION 
Gcore creates a core image of each specified process, suitable for use with adb(1) or dbx(1). 


FILES 
core.<process-id>core images 


BUGS 
Paging activity that occurs while gcore is running may cause the program to become confused. For best 
results, the desired processes should be stopped. 
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NAME 


gprof — display call graph profile data 


SYNOPSIS 


gprof [ options | [ a.out [ gmon.out ... ] ] 


DESCRIPTION 


gprof produces an execution profile of C, Pascal, or Fortran77 programs. The effect of called routines is 
incorporated in the profile of each caller. The profile data is taken from the call graph profile file (gmon.out 
default) which is created by programs which are compiled with the —pg option of cc, pc, and f77. That 
option also links in versions of the library routines which are compiled for profiling. The symbol table in 
the named object file (a.out default) is read and correlated with the call graph profile file. If more than one 
profile file is specified, the gprof output shows the sum of the profile information in the given profile files. 


First, a flat profile is given, similar to that provided by prof(1). This listing gives the total execution times 
and call counts for each of the functions in the program, sorted by decreasing time. 


Next, these times are propagated along the edges of the call graph. Cycles are discovered, and calls into a 
cycle are made to share the time of the cycle. A second listing shows the functions sorted according to the 
time they represent including the time of their call graph descendents. Below each function entry is shown 
its (direct) call graph children, and how their times are propagated to this function. A similar display above 
the function shows how this function’s time and the time of its descendents is propagated to its (direct) call 
graph parents. 


Cycles are also shown, with an entry for the cycle as a whole and a listing of the members of the cycle and 
their contributions to the time and call counts of the cycle. 


The following options are available: 


-a suppresses the printing of statically declared functions. If this option is given, all relevant infor- 
mation about the static function (e.g., time samples, calls to other functions, calls from other func- 
tions) belongs to the function loaded just before the static function in the a.out file. 


-b supresses the printing of a description of each field in the profile. 


-c the static call graph of the program is discovered by a heuristic which examines the text space of 
the object file. Static-only parents or children are indicated with call counts of 0. 


—e name 
suppresses the printing of the graph profile entry for routine name and all its descendants (unless 
they have other ancestors that aren’t suppressed). More than one —-e option may be given. Only 
one name may be given with each —-e option. 


-E name 
suppresses the printing of the graph profile entry for routine name (and its descendants) as -e, 
above, and also excludes the time spent in name (and its descendants) from the total and percent- 
age time computations. (For example, -E mcount -E mcleanup is the default.) 


-f name prints the graph profile entry of only the specified routine name and its descendants. More than 
one -f option may be given. Only one name may be given with each -f option. 


-F name 
prints the graph profile entry of only the routine name and its descendants (as -f, above) and also 
uses only the times of the printed routines in total time and percentage computations. More than 
one —F option may be given. Only one name may be given with each -F option. The —F option 
overrides the -E option. 


-s a profile file gmon.sum is produced which represents the sum of the profile information in all the 
specified profile files. This summary profile file may be given to subsequent executions of gprof 
(probably also with a —-s) to accumulate profile data across several runs of an a.out file. 
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-Z displays routines which have zero usage (as indicated by call counts and accumulated time). This 
is useful in conjunction with the -c option for discovering which routines were never called. 


FILES 

a.out the namelist and text space. 

gmon.out dynamic call graph and profile. 

gmon.sum summarized dynamic call graph and profile. 
SEE ALSO 


monitor(3), profil(2), cc(1), prof(1) 

““gprof: A Call Graph Execution Profiler’’, by Graham, S.L., Kessler, P.B., McKusick, M.K.; Proceedings 
of the SIGPLAN ’82 Symposium on Compiler Construction, SIGPLAN Notices, Vol. 17, No. 6, pp. 120- 
126, June 1982. 


BUGS 
Beware of quantization errors. The granularity of the sampling is shown, but remains statistical at best. 
We assume that the time for each execution of a function can be expressed by the total time for the function 
divided by the number of times the function is called. Thus the time propagated along the call graph arcs to 
parents of that function is directly proportional to the number of times that arc is traversed. 


Parents which are not themselves profiled will have the time of their profiled children propagated to them, 
but they will appear to be spontaneously invoked in the call graph listing, and will not have their time prop- 
agated further. Similarly, signal catchers, even though profiled, will appear to be spontaneous (although for 
more obscure reasons). Any profiled children of signal catchers should have their times propagated prop- 
erly, unless the signal catcher was invoked during the execution of the profiling routine, in which case all is 
lost. 


The profiled program must call exit(2) or return normally for the profiling information to be saved in the 
gmon.out file. 
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graph — draw a graph 


SYNOPSIS 


graph [ option ] ... 


DESCRIPTION 


Graph with no options takes pairs of numbers from the standard input as abscissas and ordinates of a graph. 
Successive points are connected by straight lines. The graph is encoded on the standard output for display 
by the plot(1G) filters. 


If the coordinates of a point are followed by a nonnumeric string, that string is printed as a label beginning 
on the point. Labels may be surrounded with quotes "...", in which case they may be empty or contain 
blanks and numbers; labels never contain newlines. 


The following options are recognized, each as a separate argument. 


-—a 


-t 


Supply abscissas automatically (they are missing from the input); spacing is given by the next 
argument (default 1). A second optional argument is the starting point for automatic abscissas 
(default 0 or lower limit given by —x). 


Break (disconnect) the graph after each label in the input. 

Character string given by next argument is default label for each point. 

Next argument is grid style, 0 no grid, | frame with ticks, 2 full grid (default). 
Next argument is label for graph. 


Next argument is mode (style) of connecting lines: 0 disconnected, 1 connected (default). Some 
devices give distinguishable line styles for other small integers. 


Save screen, don’t erase before plotting. 


If lis present, x axis is logarithmic. Next | (or 2) arguments are lower (and upper) x limits. Third 
argument, if present, is grid spacing on x axis. Normally these quantities are determined automati- 
cally. 


Similarly for y. 

Next argument is fraction of space for height. 

Similarly for width. 

Next argument is fraction of space to move right before plotting. 
Similarly to move up before plotting. 


Transpose horizontal and vertical axes. (Option —x now applies to the vertical axis.) 


A legend indicating grid range is produced with a grid unless the —-s option is present. 


If a specified lower limit exceeds the upper limit, the axis is reversed. 


SEE ALSO 


spline(1G), plot(1G) 


BUGS 


Graph stores all points internally and drops those for which there isn’t room. 
Segments that run out of bounds are dropped, not windowed. 
Logarithmic axes may not be reversed. 
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NAME 
grep, egrep, fgrep — search a file for a pattern 


SYNOPSIS 
grep [ option ] ... expression [ file ] ... 
egrep [ option ] ... [ expression ] [ file ] ... 
fgrep [ option ] ... [ strings ] [ file ] 

DESCRIPTION 
Commands of the grep family search the input files (standard input default) for lines matching a pattern. 
Normally, each line found is copied to the standard output. Grep patterns are limited regular expressions in 
the style of ex(1); it uses a compact nondeterministic algorithm. Egrep patterns are full regular expres- 


sions; it uses a fast deterministic algorithm that sometimes needs exponential space. Fgrep patterns are 
fixed strings; it is fast and compact. The following options are recognized. 


-v All lines but those matching are printed. 

-x (Exact) only lines matched in their entirety are printed (fgrep only). 

—c Only a count of matching lines is printed. 

-l The names of files with matching lines are listed (once) separated by newlines. 

—n Each line is preceded by its relative line number in the file. 

-b Each line is preceded by the block number on which it was found. This is sometimes useful in 


locating disk block numbers by context. 


-i The case of letters is ignored in making comparisons — that is, upper and lower case are consid- 
ered identical. This applies to grep and fgrep only. 


-s Silent mode. Nothing is printed (except error messages). This is useful for checking the error sta- 
tus. 
-wWw The expression is searched for as a word (as if surrounded by ‘\<’ and ‘\>’, see ex(1).) (grep only) 


—e expression 
Same as a simple expression argument, but useful when the expression begins with a-. 


-ffile The regular expression (egrep) or string list (fgrep) is taken from the file. 


In all cases the file name is shown if there is more than one input file. Care should be taken when using the 
characters $ * [* | () and \ in the expression as they are also meaningful to the Shell. It is safest to enclose 
the entire expression argument in single quotes ~ *. 


F grep searches for lines that contain one of the (newline-separated) strings. 
Egrep accepts extended regular expressions. In the following description ‘character’ excludes newline: 
A \ followed by a single character other than newline matches that character. 
The character * matches the beginning of a line. 
The character $ matches the end of a line. 
A . (period) matches any character. 
A single character not otherwise endowed with special meaning matches that character. 


A string enclosed in brackets [] matches any single character from the string. Ranges of ASCII 
character codes may be abbreviated as in ‘a—z0-9’. A ] may occur only as the first character of the 
string. A literal — must be placed where it can’t be mistaken as a range indicator. 


A regular expression followed by an * (asterisk) matches a sequence of 0 or more matches of the 
regular expression. A regular expression followed by a + (plus) matches a sequence of | or more 
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matches of the regular expression. A regular expression followed by a ? (question mark) matches 
a sequence of 0 or | matches of the regular expression. 


Two regular expressions concatenated match a match of the first followed by a match of the sec- 
ond. 


Two regular expressions separated by | or newline match either a match for the first or a match for 
the second. 


A regular expression enclosed in parentheses matches a match for the regular expression. 


The order of precedence of operators at the same parenthesis level is [] then *+? then concatenation then | 
and newline. 


Ideally there should be only one grep, but we don’t know a single algorithm that spans a wide enough range 
of space-time tradeoffs. 


SEE ALSO 
ex(1), sed(1), sh(1) 


DIAGNOSTICS 
Exit status is 0 if any matches are found, | if none, 2 for syntax errors or inaccessible files. 


BUGS 
Lines are limited to 256 characters; longer lines are truncated. 
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NAME 

groups — show group memberships 
SYNOPSIS 

groups [user] 
DESCRIPTION 


The groups command shows the groups to which you or the optionally specified user belong. Each user 
belongs to a group specified in the password file /etc/passwd and possibly to other groups as specified in the 
file /etc/group. If you do not own a file but belong to the group which it is owned by then you are granted 
group access to the file. 


When a new file is created it is given the group of the containing directory. 


SEE ALSO 
setgroups(2) 
FILES 
/etc/passwd, /etc/group 


BUGS 
More groups should be allowed. 
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NAME 

head — give first few lines 
SYNOPSIS 

head [ -count | [ file... ] 
DESCRIPTION 


This filter gives the first count lines of each of the specified files, or of the standard input. If count is omit- 
ted it defaults to 10. 


SEE ALSO 
tail(1) 
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NAME 
hostid — set or print identifier of current host system 


SYNOPSIS 
hostid [ identifier ] 


DESCRIPTION 
The hostid command prints the identifier of the current host in hexadecimal. This numeric value is 
expected to be unique across all hosts and is commonly set to the host’s Internet address. The super-user 
can set the hostid by giving a hexadecimal argument or the hostname; this is usually done in the startup 
script /etc/rc.local. 


SEE ALSO 
gethostid(2), sethostid(2) 
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NAME 

hostname — set or print name of current host system 
SYNOPSIS 

hostname [ nameofhost ] 
DESCRIPTION 


The hostname command prints the name of the current host, as given before the ‘‘login’’ prompt. The 
super-user can set the hostname by giving an argument; this is usually done in the startup script 
/etc/rc.local. 


SEE ALSO 
gethostname(2), sethostname(2) 
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NAME 
indent — indent and format C program source 


SYNOPSIS 

indent [ input-file [ output-file | | [-bad | -nbad ] [-bap | -nbap ] [-bbb | -nbbb ] [ -be | -nbe 
-bl | -br] [-cn] [-cdn] [-cdb | -nedb] [-ce | -nce] [-cin] [clin] [-dn] [din 
-dj | -ndj] [-ei | -nei] [-fe1 | -nfe1] [-in] [-ip | -nip] [-In] [Alen] [-Ip | -nlp 
—npro | [-pes | —npcs ] [-ps | —nps |] [-psl | -npsl ] [-se | —nsc | [-sob | —nsob | [-st 
-troff ] [-v | -nv ] 


] 
[ ] 
[ ] 
[ ] 
[ 


DESCRIPTION 
Indent is a C program formatter. It reformats the C program in the input-file according to the switches. 
The switches which can be specified are described below. They may appear before or after the file names. 


NOTE: If you only specify an input-file, the formatting is done ‘in-place’, that is, the formatted file is writ- 
ten back into input-file and a backup copy of input-file is written in the current directory. If input-file is 
named ‘/blah/blah/file’, the backup file is named file.BAK. 


If output-file is specified, indent checks to make sure it is different from input-file. 


OPTIONS 
The options listed below control the formatting style imposed by indent. 


—bad,-nbad If —-bad is specified, a blank line is forced after every block of declarations. Default: 
—nbad. 


—bap,—nbap If -bap is specified, a blank line is forced after every procedure body. Default: -nbap. 
—bbb,—nbbb If -bbb is specified, a blank line is forced before every block comment. Default: -nbbb. 


—be,-nbc If -be is specified, then a newline is forced after each comma in a declaration. —nbe turns 
off this option. The default is -nbe. 


-br,-bl Specifying —bl lines up compound statements like this: 
if (...) 
{ 


code 


} 
Specifying —br (the default) makes them look like this: 


if (...) { 
code 
} 
-cn The column in which comments on code start. The default is 33. 
-cdn The column in which comments on declarations start. The default is for these comments 


to start in the same column as those on code. 


—cdb, -nedb Enables (disables) the placement of comment delimiters on blank lines. With this option 
enabled, comments look like this: 
/* 
* this is a comment 
**/ 
Rather than like this: 
/* this is a comment */ 
This only affects block comments, not comments to the right of code. The default is 
-cdb. 


—ce, —nce Enables (disables) forcing ‘else’s to cuddle up to the immediately preceding ‘}’. The 
default is -ce. 
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—cin 


—clin 


—din 


—dj,—ndj 


—ei, —nei 


-fcl,—nfcl 


-In 


-Ip, nlp 


—npro 


—pcs,-npes 


—ps,—nps 


—psl,—npsl 
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Sets the continuation indent to be n. Continuation lines will be indented that far from the 
beginning of the first line of the statement. Parenthesized expressions have extra inden- 
tation added to indicate the nesting, unless —Ip is in effect. —ci defaults to the same value 
as -i. 


Causes case labels to be indented n tab stops to the right of the containing switch state- 
ment. —cli0.5 causes case labels to be indented half a tab stop. The default is —cli0. 
(This is the only option that takes a fractional argument.) 


Controls the placement of comments which are not to the right of code. Specifying -d1 
means that such comments are placed one indentation level to the left of code. The 
default -d0 lines up these comments with the code. See the section on comment inden- 
tation below. 


Specifies the indentation, in character positions, from a declaration keyword to the fol- 
lowing identifier. The default is -di16. 


—dj left justifies declarations. —ndj indents declarations the same as code. The default is 
—ndj. 


Enables (disables) special else-if processing. If enabled, ifs following elses will have the 
same indentation as the preceding if statement. The default is -ei. 


Enables (disables) the formatting of comments that start in column 1. Often, comments 
whose leading ‘/’ is in column | have been carefully hand formatted by the programmer. 
In such cases, —nfcl should be used. The default is -fe1. 


The number of spaces for one indentation level. The default is 8. 


Enables (disables) the indentation of parameter declarations from the left margin. The 
default is —ip. 


Maximum length of an output line. The default is 78. 


Lines up code surrounded by parenthesis in continuation lines. If a line has a left paren 
which is not closed on that line, then continuation lines will be lined up to start at the 
character position just after the left paren. For example, here is how a piece of continued 
code looks with —nlp in effect: 
pl = first_procedure(second_procedure(p2, p3), 
third_procedure(p4, p5)); 
With -Ip in effect (the default) the code looks somewhat clearer: 
pl = first_procedure(second_procedure(p2, p3), 
third_procedure(p4, p5)); 
Inserting two more newlines we get: 
pl = first_procedure(second_procedure(p2, 
p3), 
third_procedure(p4, 
p5)); 
Causes the profile files, ‘./.indent.pro’ and ‘/.indent.pro’, to be ignored. 


If true (—pes) all procedure calls will have a space inserted between the name and the ‘(’. 
The default is -npes. 


If true (-ps) the pointer following operator ‘—>’ will be surrounded by spaces on either 
side. The default is —-nps. 


If true (-psl) the names of procedures being defined are placed in column 1 — their types, 
if any, will be left on the previous lines. The default is —psl. 
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—sc,—nsc Enables (disables) the placement of asterisks (“*’s) at the left edge of all comments. The 
default is -se. 

—sob,—nsob If -sob is specified, indent will swallow optional blank lines. You can use this to get rid 
of blank lines after declarations. Default: —-nsob. 

-st Causes indent to take its input from stdin, and put its output to stdout. 

-Ttypename Adds typename to the list of type keywords. Names accumulate: -T can be specified 


more than once. You need to specify all the typenames that appear in your program that 
are defined by typedefss — nothing will be harmed if you miss a few, but the program 
won't be formatted as nicely as it should. This sounds like a painful thing to have to do, 
but it’s really a symptom of a problem in C: typedef causes a syntactic change in the lan- 
guage and indent can’t find all typedefs. 


-troff Causes indent to format the program for processing by troff. It will produce a fancy list- 
ing in much the same spirit as vgrind. If the output file is not specified, the default is 
standard output, rather than formatting in place. 


-V,-nv -v turns on ‘verbose’ mode; —nv turns it off. When in verbose mode, indent reports 
when it splits one line of input into two or more lines of output, and gives some size 
statistics at completion. The default is —nv. 


FURTHER DESCRIPTION 
You may set up your own ‘profile’ of defaults to indent by creating a file called .indent.pro in either your 
login directory and/or the current directory and including whatever switches you like. Switches in 
“indent.pro’ in the current directory override those in your login directory (with the exception of -T type 
definitions, which just accumulate). If indent is run and a profile file exists, then it is read to set up the 
program’s defaults. The switches should be separated by spaces, tabs or newlines. Switches on the com- 
mand line, however, override profile switches. 


Comments 


‘Box’ comments. Indent assumes that any comment with a dash or star immediately after the start of com- 
ment (that is, ‘/*—’ or ‘/**’) is a comment surrounded by a box of stars. Each line of such a comment is left 
unchanged, except that its indentation may be adjusted to account for the change in indentation of the first 
line of the comment. 


Straight text. All other comments are treated as straight text. Indent fits as many words (separated by 
blanks, tabs, or newlines) on a line as possible. Blank lines break paragraphs. 


Comment indentation 


If a comment is on a line with code it is started in the “comment column’, which is set by the -en command 
line parameter. Otherwise, the comment is started at n indentation levels less than where code is currently 
being placed, where n is specified by the -dn command line parameter. If the code on a line extends past 
the comment column, the comment starts further to the right, and the right margin may be automatically 
extended in extreme cases. 


Preprocessor lines 


In general, indent leaves preprocessor lines alone. The only reformatting that it will do is to straighten up 
trailing comments. It leaves embedded comments alone. Conditional compilation (#ifdef...#endif) is rec- 
ognized and indent attempts to correctly compensate for the syntactic peculiarities introduced. 


C syntax 


Indent understands a substantial amount about the syntax of C, but it has a ‘forgiving’ parser. It attempts to 
cope with the usual sorts of incomplete and misformed syntax. In particular, the use of macros like: 

#define forever for(;;) 
is handled properly. 
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FILES 
./.indent.pro profile file 
“/.indent.pro profile file 


BUGS 
Indent has even more switches than I/s. 


A common mistake that often causes grief is typing: 


indent *.c 
to the shell in an attempt to indent all the C programs in a directory. This is probably a bug, not a feature. 
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NAME 
install — install binaries 

SYNOPSIS 
install [ -c ] [—m mode ] [ -o owner ] [ -g group ] [ -s ] binary destination 

DESCRIPTION 
Binary is moved (or copied if —c is specified) to destination. If destination already exists, it is removed 
before binary is moved. If the destination is a directory then binary is moved into the destination directory 
with its original file-name. 
The mode for Destination is set to 755; the -m mode option may be used to specify a different mode. 
Destination is changed to owner root; the -o owner option may be used to specify a different owner. 
Destination is changed to group staff; the -g group option may be used to specify a different group. 
If the -s option is specified the binary is stripped after being installed. 
Install refuses to move a file onto itself. 

SEE ALSO 


chgrp(1), chmod(1), cp(1), mv(1), strip(1), chown(8) 
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NAME 
iostat — report I/O statistics 

SYNOPSIS 
iostat [ drives ] [ interval [ count ] ] 

DESCRIPTION 
Tostat iteratively reports the number of characters read and written to terminals per second, and, for each 
disk, the number of transfers per second, kilobytes transferred per second, and the milliseconds per average 
seek. It also gives the percentage of time the system has spent in user mode, in user mode running low pri- 
ority (niced) processes, in system mode, and idling. 
To compute this information, for each disk, seeks and data transfer completions and number of words trans- 
ferred are counted; for terminals collectively, the number of input and output characters are counted. Also, 
each sixtieth of a second, the state of each disk is examined and a tally is made if the disk is active. From 
these numbers and given the transfer rates of the devices it is possible to determine average seek times for 
each device. 
The optional interval argument causes iostat to report once each interval seconds. The first report is for all 
time since a reboot and each subsequent report is for the last interval only. 
The optional count argument restricts the number of reports. 
If more than 4 disk drives are configured in the system, iostat displays only the first 4 drives, with priority 
given to Massbus disk drives (i.e. if both Unibus and Massbus drives are present and the total number of 
drives exceeds 4, then some number of Unibus drives will not be displayed in favor of the Massbus drives). 
To force iostat to display specific drives, their names may be supplied on the command line. 

FILES 
/dev/kmem 
/vmunix 

SEE ALSO 
vmstat(1) 
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NAME 
join — relational database operator 


SYNOPSIS 
join [ options ] file! file2 


DESCRIPTION 
Join forms, on the standard output, a join of the two relations specified by the lines of file/ and file2. If 
filel is ‘—’, the standard input is used. 


File and file2 must be sorted in increasing ASCII collating sequence on the fields on which they are to be 
joined, normally the first in each line. 


There is one line in the output for each pair of lines in file] and file2 that have identical join fields. The out- 
put line normally consists of the common field, then the rest of the line from file/, then the rest of the line 
from file2. 


Fields are normally separated by blank, tab or newline. In this case, multiple separators count as one, and 
leading separators are discarded. 


These options are recognized: 

—an In addition to the normal output, produce a line for each unpairable line in file n, where n is | or 2. 
-es Replace empty output fields by string s. 

-jnm — Joinon the mth field of filen. If n is missing, use the mth field in each file. 


-o list Each output line comprises the fields specified in list, each element of which has the form n.m, 
where n is a file number and m is a field number. 


-tc Use character c as a separator (tab character). Every appearance of c in a line is significant. 


SEE ALSO 
sort(1), comm(1), awk(1) 


BUGS 
With default field separation, the collating sequence is that of sort—b; with -t, the sequence is that of a 
plain sort. 


The conventions of join, sort, comm, unig, look and awk(1) are wildly incongruous. 
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NAME 
kill — terminate a process with extreme prejudice 


SYNOPSIS 
kill [ -sig ] processid ... 
kill -I 


DESCRIPTION 
Kill sends the TERM (terminate, 15) signal to the specified processes. If a signal name or number preceded 
by ‘—’ is given as first argument, that signal is sent instead of terminate (see sigvec(2)). The signal names 
are listed by ‘kill -I’, and are as given in /usr/include/signal.h, stripped of the common SIG prefix. 


The terminate signal will kill processes that do not catch the signal; ‘kill —-9 ...’ is a sure kill, as the KILL 
(9) signal cannot be caught. By convention, if process number 0 is specified, all members in the process 
group (i.e. processes resulting from the current login) are signaled (but beware: this works only if you use 
sh(1); not if you use csh(1).) Negative process numbers also have special meanings; see kill(2) for details. 


The killed processes must belong to the current user unless he is the super-user. 


The process number of an asynchronous process started with ‘&’ is reported by the shell. Process numbers 
can also be found by using ps(1). Kill is a built-in to csh(1); it allows job specifiers of the form ‘*%...’’ as 
arguments so process id’s are not as often used as kill arguments. See csh(1) for details. 


SEE ALSO 
csh(1), ps(1), kill(2), sigvec(2) 


BUGS 
A replacement for ‘‘kill 0”’ for csh(1) users should be provided. 
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NAME 


last — indicate last logins of users and teletypes 


SYNOPSIS 


last [-N ] [name... ] [ tty... ] 


DESCRIPTION 


Last will look back in the wimp file which records all logins and logouts for information about a user, a 
teletype or any group of users and teletypes. Arguments specify names of users or teletypes of interest. 
Names of teletypes may be given fully or abbreviated. For example ‘last 0’ is the same as ‘last tty0’. If 
multiple arguments are given, the information which applies to any of the arguments is printed. For exam- 
ple ‘last root console’ would list all of "root’s" sessions as well as all sessions on the console terminal. Last 
will print the sessions of the specified users and teletypes, most recent first, indicating the times at which 
the session began, the duration of the session, and the teletype which the session took place on. If the ses- 


sion is still continuing or was cut short by a reboot, last so indicates. 
The pseudo-user reboot logs in at reboots of the system, thus 

last reboot 
will give an indication of mean time between reboot. 


Last with no arguments prints a record of all logins and logouts, in reverse order. The —N option limits the 
report to N lines. 


If /ast is interrupted, it indicates how far the search has progressed in wtmp. If interrupted with a quit signal 
(generated by a control-\) /ast indicates how far the search has progressed so far, and the search continues. 


FILES 

/usr/adm/wtmp login data base 

/usr/adm/shutdownlog which records shutdowns and reasons for same 
SEE ALSO 

wtmp(5), ac(8), lastecomm(1) 
AUTHOR 


Howard Katseff 
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NAME 


lastcomm — show last commands executed in reverse order 


SYNOPSIS 


lastcomm [ command name ] ... [user name] ... [terminal name] ... 


DESCRIPTION 


FILES 


Lastcomm gives information on previously executed commands. With no arguments, /astcomm prints 
information about all the commands recorded during the current accounting file’s lifetime. If called with 
arguments, only accounting entries with a matching command name, user name, or terminal name are 
printed. So, for example, 

lastcomm a.out root ttydO 
would produce a listing of all the executions of commands named a.out by user root on the terminal ttyd0. 


For each process entry, the following are printed. 
The name of the user who ran the process. 
Flags, as accumulated by the accounting facilities in the system. 
The command name under which the process was called. 
The amount of cpu time used by the process (in seconds). 
The time the process exited. 


The flags are encoded as follows: ‘‘S’’ indicates the command was executed by the super-user, “‘F’’ indi- 
cates the command ran after a fork, but without a following exec, ‘‘C’’ indicates the command was run in 
PDP-11 compatibility mode (VAX only), ‘‘D’’ indicates the command terminated with the generation of a 
core file, and ‘*X’’ indicates the command was terminated with a signal. 


/usr/adm/acct 


SEE ALSO 


last(1), sigvec(2), acct(8), core(5) 
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NAME 
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ld — link editor 


SYNOPSIS 


Id [ option ] ... file ... 


DESCRIPTION 


Ld combines several object programs into one, resolves external references, and searches libraries. In the 
simplest case several object files are given, and Jd combines them, producing an object module which can 
be either executed or become the input for a further /d run. (In the latter case, the -r option must be given 
to preserve the relocation bits.) The output of /d is left on a.out. This file is made executable only if no 
errors occurred during the load. 


The argument routines are concatenated in the order specified. The entry point of the output is the begin- 
ning of the first routine (unless the -e option is specified). 


If any argument is a library, it is searched exactly once at the point it is encountered in the argument list. 
Only those routines defining an unresolved external reference are loaded. If a routine from a library refer- 
ences another routine in the library, and the library has not been processed by ranlib(1), the referenced rou- 
tine must appear after the referencing routine in the library. Thus the order of programs within libraries 
may be important. The first member of a library should be a file named ‘__.SYMDEF’, which is under- 
stood to be a dictionary for the library as produced by ranlib(1); the dictionary is searched iteratively to sat- 
isfy as many references as possible. 


The symbols ‘ etext’, ‘ edata’ and ‘ end’ (‘etext’, ‘edata’ and ‘end’ in C) are reserved, and if referred to, 
are set to the first location above the program, the first location above initialized data, and the first location 
above all data respectively. It is erroneous to define these symbols. 


Ld understands several options. Except for -I, they should appear before the file names. 


-A This option specifies incremental loading, i.e. linking is to be done in a manner so that the result- 
ing object may be read into an already executing program. The next argument is the name of a file 
whose symbol table will be taken as a basis on which to define additional symbols. Only newly 
linked material will be entered into the text and data portions of a.out, but the new symbol table 
will reflect every symbol defined before and after the incremental load. This argument must 
appear before any other object file in the argument list. The —-T option may be used as well, and 
will be taken to mean that the newly linked segment will commence at the corresponding address 
(which must be a multiple of 1024). The default value is the old value of end. 


-D Take the next argument as a hexadecimal number and pad the data segment with zero bytes to the 
indicated length. 


-d Force definition of common storage even if the -r flag is present. 


-e The following argument is taken to be the name of the entry point of the loaded program; location 
O is the default. 


-Ldir Add dir to the list of directories in which libraries are searched for. Directories specified with —L 
are searched before the standard directories. 


-lx This option is an abbreviation for the library name ‘libx.a’, where x is a string. Ld searches for 
libraries first in any directories specified with —L options, then in the standard directories “/lib’, 
‘/usr/lib’, and ‘/usr/local/lib’. A library is searched when its name is encountered, so the place- 
ment of a —] is significant. 


—M produce a primitive load map, listing the names of the files which will be loaded. 
—-N Do not make the text portion read only or sharable. (Use "magic number" 0407.) 
—n Arrange (by giving the output file a 0410 "magic number") that when the output file is executed, 


the text portion will be read-only and shared among all users executing the file. This involves 
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moving the data areas up to the first possible 1024 byte boundary following the end of the text. 


-0 The name argument after —-0 is used as the name of the /d output file, instead of a.out. 

—r Generate relocation bits in the output file so that it can be the subject of another /d run. This flag 
also prevents final definitions from being given to common symbols, and suppresses the 
‘undefined symbol’ diagnostics. 

-S ‘Strip’ the output by removing all symbols except locals and globals. 

-s ‘Strip’ the output, that is, remove the symbol table and relocation bits to save space (but impair the 
usefulness of the debuggers). This information can also be removed by strip (1). 

-T The next argument is a hexadecimal number which sets the text segment origin. The default origin 
is 0. 

-t ("trace") Print the name of each file as it is processed. 

-u Take the following argument as a symbol and enter it as undefined in the symbol table. This is 
useful for loading wholly from a library, since initially the symbol table is empty and an unre- 
solved reference is needed to force the loading of the first routine. 

-X Save local symbols except for those whose names begin with ‘L’. This option is used by cc(1) to 
discard internally-generated labels while retaining symbols local to routines. 

-x Do not preserve local (non-.globl) symbols in the output symbol table; only enter external sym- 
bols. This option saves some space in the output file. 

-ysym Indicate each file in which sym appears, its type and whether the file defines or references it. Many 
such options may be given to trace many symbols. (It is usually necessary to begin sym with an 
* ’, as external C, FORTRAN and Pascal variables begin with underscores.) 

-Z Arrange for the process to be loaded on demand from the resulting executable file (413 format) 
rather than preloaded. This is the default. Results in a 1024 byte header on the output file fol- 
lowed by a text and data segment each of which have size a multiple of 1024 bytes (being padded 
out with nulls in the file if necessary). With this format the first few BSS segment symbols may 
actually appear (from the output of size(1)) to live in the data segment; this to avoid wasting the 
space resulting from data segment size roundup. 

FILES 

Nib/lib*.a libraries 

/ust/lib/lib*.a more libraries 

/usr/local/lib/lib*.a_ still more libraries 

a.out output file 

SEE ALSO 


as(1), ar(1), cc(1), ranlib(1) 


BUGS 


There is no way to force data to be page aligned. Ld pads images which are to be demand loaded from the 
file system to the next page boundary to avoid a bug in the system. 
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NAME 


learn — computer aided instruction about UNIX 


SYNOPSIS 


learn [ -directory ] [ subject [ lesson ] ] 


DESCRIPTION 


Learn gives Computer Aided Instruction courses and practice in the use of UNIX, the C Shell, and the 
Berkeley text editors. To get started simply type learn. If you had used learn before and left your last ses- 
sion without completing a subject, the program will use information in $HOME/ learnrc to start you up in 
the same place you left off. Your first time through, /earn will ask questions to find out what you want to 
do. Some questions may be bypassed by naming a subject, and more yet by naming a /esson. You may 
enter the /esson as a number that learn gave you in a previous session. If you do not know the lesson num- 
ber, you may enter the /esson as a word, and learn will look for the first lesson containing it. If the lesson is 
‘~’, learn prompts for each lesson; this is useful for debugging. 


The subject ’s presently handled are 


files 
editor 

vi 
morefiles 
macros 
eqn 

C 


There are a few special commands. The command ‘bye’ terminates a /Jearn session and ‘where’ tells you of 
your progress, with ‘where m’ telling you more. The command ‘again’ re-displays the text of the lesson 
and ‘again lesson’ lets you review lesson. There is no way for learn to tell you the answers it expects in 
English, however, the command ‘hint’ prints the last part of the lesson script used to evaluate a response, 
while ‘hint m’ prints the whole lesson script. This is useful for debugging lessons and might possibly give 
you an idea about what it expects. 


The —directory option allows one to exercise a script in a nonstandard place. 


FILES 

/asr/lib/learn subtree for all dependent directories and files 

/usr/tmp/p|* playpen directories 

$HOME/.learnre startup information 
SEE ALSO 

csh(1), ex(1) 

B. W. Kernighan and M. E. Lesk, LEARN — Computer-Aided Instruction on UNIX 
BUGS 


The main strength of learn, that it asks the student to use the real UNIX, also makes possible baffling mis- 
takes. It is helpful, especially for nonprogrammers, to have a UNIX initiate near at hand during the first 
sessions. 


Occasionally lessons are incorrect, sometimes because the local version of a command operates in a non- 
standard way. Occasionally a lesson script does not recognize all the different correct responses, in which 
case the ‘hint? command may be useful. Such lessons may be skipped with the ‘skip’ command, but it 
takes some sophistication to recognize the situation. 


To find a /esson given as a word, learn does a simple fgrep(1) through the lessons. It is unclear whether 
this sort of subject indexing is better than none. 


Spawning a new shell is required for each of many user and internal functions. 
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The ‘vi’ lessons are provided separately from the others. To use them see your system administrator. 
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NAME 
leave — remind you when you have to leave 


SYNOPSIS 
leave [ [+]hhmm ]| 


DESCRIPTION 
Leave waits until the specified time, then reminds you that you have to leave. You are reminded 5 minutes 
and | minute before the actual time, at the time, and every minute thereafter. When you log off, leave exits 
just before it would have printed the next message. 


The time of day is in the form hhmm where hh is a time in hours (on a 12 or 24 hour clock). All times are 
converted to a 12 hour clock, and assumed to be in the next 12 hours. 


If the time is preceeded by ‘+’, the alarm will go off in hours and minutes from the current time. 


If no argument is given, /eave prompts with "When do you have to leave?". A reply of newline causes leave 
to exit, otherwise the reply is assumed to be a time. This form is suitable for inclusion in a .Jogin or 
-profile. 

Leave ignores interrupts, quits, and terminates. To get rid of it you should either log off or use ‘‘kill -9”’ 
giving its process id. 


SEE ALSO 
calendar(1) 
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NAME 
lex — generator of lexical analysis programs 


SYNOPSIS 
lex [ -tvfn ] [ file ] ... 


DESCRIPTION 
Lex generates programs to be used in simple lexical analyis of text. The input files (standard input default) 
contain regular expressions to be searched for, and actions written in C to be executed when expressions are 
found. 


AC source program, ’lex.yy.c’ is generated, to be compiled thus: 
cc lex.yy.c —ll 


This program, when run, copies unrecognized portions of the input to the output, and executes the associ- 
ated C action for each regular expression that is recognized. 


The options have the following meanings. 


-t Place the result on the standard output instead of in file "lex.yy.c". 

-vV Print a one-line summary of statistics of the generated analyzer. 

—n Opposite of —v; —n is default. 

-f "Faster" compilation: don’t bother to pack the resulting tables; limited to small programs. 
EXAMPLE 


lex lexcommands 


would draw J/ex instructions from the file /excommands, and place the output in lex.yy.c 


[A—Z] putchar(yytext[0]+’a—“A’); 

[]+$ ; 

[]+ putchar(’ ’); 
is an example of a /ex program that would be put into a Jex command file. This program converts upper 
case to lower, removes blanks at the end of lines, and replaces multiple blanks by single blanks. 


SEE ALSO 
yacc(1), sed(1) 
M. E. Lesk and E. Schmidt, LEX — Lexical Analyzer Generator 
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NAME 
lint — a C program verifier 


SYNOPSIS 
lint [ -abchnpuvx | file ... 


DESCRIPTION 
Lint attempts to detect features of the C program files which are likely to be bugs, or non-portable, or waste- 
ful. It also checks the type usage of the program more strictly than the compilers. Among the things which 
are currently found are unreachable statements, loops not entered at the top, automatic variables declared 
and not used, and logical expressions whose value is constant. Moreover, the usage of functions is checked 
to find functions which return values in some places and not in others, functions called with varying num- 
bers of arguments, and functions whose values are not used. 


By default, it is assumed that all the files are to be loaded together; they are checked for mutual compatibil- 
ity. Function definitions for certain libraries are available to lint; these libraries are referred to by a conven- 
tional name, such as ‘—Im’, in the style of /d(1). Arguments ending in ./n are also treated as library files. 
To create lint libraries, use the —C option: 


lint —Cfoo files... 


where files are the C sources of library foo. The result is a file //ib-/foo.In in the correct library format suit- 
able for linting programs using foo. 


Any number of the options in the following list may be used. The -D, -U, and -I options of cc(1) are also 
recognized as separate arguments. 


p Attempt to check portability to the BM and GCOS dialects of C. 
h Apply a number of heuristic tests to attempt to intuit bugs, improve style, and reduce waste. 
b Report break statements that cannot be reached. (This is not the default because, unfortunately, 


most /ex and many yacc outputs produce dozens of such comments.) 


v Suppress complaints about unused arguments in functions. 

x Report variables referred to by extern declarations, but never used. 

a Report assignments of long values to int variables. 

c Complain about casts which have questionable portability. 

u Do not complain about functions and variables used and not defined, or defined and not used (this 


is suitable for running Jint on a subset of files out of a larger program). 
n Do not check compatibility against the standard library. 


Z Do not complain about structures that are never defined (e.g. using a structure pointer without 
knowing its contents.). 
Exit(2) and other functions which do not return are not understood; this causes various lies. 


Certain conventional comments in the C source will change the behavior of Jint: 


/*NOTREACHED*/ 
at appropriate points stops comments about unreachable code. 


/*V ARARGSn#/ 
suppresses the usual checking for variable numbers of arguments in the following function decla- 
ration. The data types of the first n arguments are checked; a missing n is taken to be 0. 


/*NOSTRICT*#/ 
shuts off strict type checking in the next expression. 


/*ARGSUSED*/ 
turns on the —v option for the next function. 
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/*LINTLIBRARY*/ 
at the beginning of a file shuts off complaints about unused functions in this file. 


AUTHOR 


FILES 


S.C. Johnson. Lint library construction implemented by Edward Wang. 


/usr/lib/lint/lint[ 12] programs 

/usr/lib/int/lib-Ic.In — declarations for standard functions 
/usr/lib/lint/llib-Ic human readable version of above 
/usr/lib/lint/llib-port.In declarations for portable functions 
/usr/lib/lint/llib-port | human readable... 

llib-1* In library created with —C 


SEE ALSO 


BUGS 


cc(1) 
S.C. Johnson, Lint, a C Program Checker 


There are some things you just can’t get lint to shut up about. 


/*NOSTRICT*/ is not implemented in the current version (alas). 
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NAME 

lisp — lisp interpreter 
SYNOPSIS 

lisp 
DESCRIPTION 


Lisp is a lisp interpreter for a dialect which closely resembles MIT’s MACLIsP. This lisp, known as 
FRANZ LISP, features an I/O facility which allows the user to change the input and output syntax, add macro 
characters, and maintain compatibility with upper-case only lisp systems; infinite precision integer arith- 
metic, and an error facility which allows the user to trap system errors in many different ways. Interpreted 
functions may be mixed with code compiled by liszt(1) and both may be debugged using the “‘Joseph Lis- 
ter’’ trace package. A lisp containing compiled and interpreted code may be dumped into a file for later 
use. 


There are too many functions to list here; one should refer to the manuals listed below. 


AUTHORS 
An early version was written by Jeff Levinsky, Mike Curry, and John Breedlove. Keith Sklower wrote and 
is maintaining the current version, with the assistance of John Foderaro. The garbage collector was imple- 


mented by Bill Rowan. 
FILES 
/usr/lib/lisp/trace.1 Joseph Lister trace package 
/usr/lib/lisp/toplevel.1 top level read-eval-print loop 
SEE ALSO 


liszt(1), Ixref(1) 
‘FRANZ Lisp Manual, Version 1’ by John K. Foderaro 
MACLISP Manual 


BUGS 
The error system is in a state of flux and not all error messages are as informative as they could be. 
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NAME 


liszt — compile a Franz Lisp program 


SYNOPSIS 


liszt [—mpqruwxCQST ] [ -e form ] [ -o objfile ] [ name ] 


DESCRIPTION 


Liszt takes a file whose names ends in ‘.l’ and compiles the FRANZ LISP code there leaving an object pro- 
gram on the file whose name is that of the source with ‘.o’ substituted for ‘I’. 


The following options are interpreted by Jiszt. 


-e Evaluate the given form before compilation begins. 

—m Compile a MACLISP file, by changing the readtable to conform to MACLISP syntax and including a 
macro-defined compatibility package. 

-0 Put the object code in the specified file, rather than the default ‘.o’ file. 

-p places profiling code at the beginning of each non-local function. If the lisp system is also created 


with profiling in it, this allows function calling frequency to be determined (see prof(1).) 


-q Only print warning and error messages. Compilation statistics and notes on correct but unusual 
constructs will not be printed. 


-r place bootstrap code at the beginning of the object file, which when the object file is executed will 
cause a lisp system to be invoked and the object file fasl’ ed in. 


-u Compile a UCI-lispfile, by changing the readtable to conform to UCI-Lisp syntax and including a 
macro-defined compatibility package. 


-w Suppress warning diagnostics. 


-x Create a lisp cross reference file with the same name as the source file but with ‘.x’ appended. 
The program /xref(1) reads this file and creates a human readable cross reference listing. 


-C put comments in the assembler output of the compiler. Useful for debugging the compiler. 
-Q Print compilation statistics and warn of strange constructs. This is the default. 
-S Compile the named program and leave the assembler-language output on the corresponding file 


suffixed ‘.s’. This will also prevent the assembler language file from being assembled. 
-T send the assembler output to standard output. 


If no source file is specified, then the compiler will run interactively. You will find yourself talking to the 
lisp(1) top-level command interpreter. You can compile a file by using the function /iszt (an nlambda) with 
the same arguments as you use on the command line. For example to compile ‘foo’, a MACLISP file, you 
would use: 


(liszt —m foo) 


Note that Jiszt supplies the ‘‘.I’’ extension for you. 


FILES 
/ust/lib/lisp/machacks.1 MACLISP compatibility package 
/usr/lib/lisp/syscall.1 macro definitions of Unix system calls 
/usr/lib/lisp/ucifne.1 UCI Lisp compatibility package 
AUTHOR 


John Foderaro 


SEE ALSO 


lisp(1), Ixref(1) 
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NAME 
In — make links 


SYNOPSIS 
In [-s ] sourcename [ targetname ] 
In [-s ] sourcename! sourcename?2 [ sourcename3 ... | targetdirectory 


DESCRIPTION 
A link is a directory entry referring to a file; the same file (together with its size, all its protection informa- 
tion, etc.) may have several links to it. There are two kinds of links: hard links and symbolic links. 


By default /n makes hard links. A hard link to a file is indistinguishable from the original directory entry; 
any changes to a file are effective independent of the name used to reference the file. Hard links may not 
span file systems and may not refer to directories. 


The -s option causes /n to create symbolic links. A symbolic link contains the name of the file to which it 
is linked. The referenced file is used when an open(2) operation is performed on the link. A stat(2) on a 
symbolic link will return the linked-to file; an /stat(2) must be done to obtain information about the link. 
The readlink(2) call may be used to read the contents of a symbolic link. Symbolic links may span file sys- 
tems and may refer to directories. 


Given one or two arguments, /n creates a link to an existing file sourcename. If targetname is given, the 
link has that name; fargetname may also be a directory in which to place the link; otherwise it is placed in 
the current directory. If only the directory is specified, the link will be made to the last component of 
sourcename . 


Given more than two arguments, /n makes links in targetdirectory to all the named source files. The links 
made will have the same name as the files being linked to. 


SEE ALSO 
rm(1), cp(1), mv(1), link(2), readlink(2), stat(2), symlink(2) 
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NAME 
lock — reserve a terminal 


SYNOPSIS 
lock [ -number | 


DESCRIPTION 
Lock requests a password from the user, reads it again for verification and then it will normally not relin- 
quish the terminal until the password is repeated. There are three other conditions under it will terminate: it 
accepts the password for root as an alternative to the one given by the user, it will timeout after some inter- 
val of time, and it may be killed by somebody with the appropiate permission. The default time limit is 15 
minutes but it may be changed with the number option where number is the time limit in minutes. 
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NAME 
logger — make entries in the system log 
SYNOPSIS 
logger [ -t tag ] [-p pri ] [-i ] [ -f file ] [ message ... ] 
ARGUMENTS 
-t tag Mark every line in the log with the specified tag. 
=p pri Enter the message with the specified priority. The priority may be specified numerically or 
as a ‘‘facility.level’’ pair. For example, ‘‘-p local3.info’’ logs the message(s) as 
informational level in the /ocal3 facility. The default is ‘‘user.notice.”’ 
-i Log the process id of the logger process with each line. 
-f file Log the specified file. 
message The message to log; if not specified, the -f file or standard input is logged. 
DESCRIPTION 


Logger provides a program interface to the syslog(3) system log module. 


A message can be given on the command line, which is logged immediately, or a file is read and each line 
is logged. 


EXAMPLES 
logger System rebooted 


logger —p local0.notice -t HOSTIDM -f /dev/idmce 


SEE ALSO 
syslog(3), syslogd(8) 
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NAME 
login — sign on 


SYNOPSIS 
login [ —p ] [ username ] 


DESCRIPTION 
The /ogin command is used when a user initially signs on, or it may be used at any time to change from one 
user to another. The latter case is the one summarized above and described here. See ‘‘How to Get 
Started’’ for how to dial up initially. 


If Jogin is invoked without an argument, it asks for a user name, and, if appropriate, a password. Echoing is 
turned off (if possible) during the typing of the password, so it will not appear on the written record of the 
session. 


After a successful login, accounting files are updated and the user is informed of the existence of mail. The 
message of the day is printed, as is the time of his last login. Both are suppressed if he has a ‘‘-hushlogin’’ 
file in his home directory; this is mostly used to make life easier for non-human users, such as uucp. 


Login initializes the user and group IDs and the working directory, then executes a command interpreter 
(usually csh(1)) according to specifications found in a password file. Argument 0 of the command inter- 
preter is the name of the command interpreter with a leading dash (““—’’). 


Login also modifies the environment environ(7) with information specifying home directory, command 
interpreter, terminal type (if available) and user name. The ‘—p’ argument causes the remainder of the envi- 
ronment to be preserved, otherwise any previous environment is discarded. 


If the file /etc/nologin exists, Jogin prints its contents on the user’s terminal and exits. This is used by shut- 
down(8) to stop users logging in when the system is about to go down. 


Login is recognized by sh(1) and csh(1) and executed directly (without forking). 


FILES 

/etc/utmp accounting 

/usr/adm/wtmp accounting 

/asr/spool/mail/* mail 

/etc/motd message-of-the-day 

/etc/passwd password file 

/etc/nologin stops logins 

-hushlogin makes login quieter 
SEE ALSO 

init(8), getty(8), mail(1), passwd(1), passwd(5), environ(7), shutdown(8), rlogin(1c) 
DIAGNOSTICS 

‘‘Login incorrect,’’ if the name or the password is bad. 

“*No Shell’, ‘‘cannot open password file’’, ‘no directory’’: consult a programming counselor. 
BUGS 


An undocumented option, —r is used by the remote login server, rlogind(8C) to force /ogin to enter into an 
initial connection protocol. —h is used by te/netd(8C) and other servers to list the host from which the con- 
nection was received. 
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NAME 
look — find lines in a sorted list 


SYNOPSIS 
look [ -df ] string [ file ] 


DESCRIPTION 
Look consults a sorted file and prints all lines that begin with string. It uses binary search. 


The options d and f affect comparisons as in sort(1): 

d= ‘Dictionary’ order: only letters, digits, tabs and blanks participate in comparisons. 
f Fold. Upper case letters compare equal to lower case. 

If no file is specified, /usr/dict/words is assumed with collating sequence -df. 


FILES 
/usr/dict/words 


SEE ALSO 
sort(1), grep(1) 
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NAME 


indxbib, lookbib — build inverted index for a bibliography, find references in a bibliography 


SYNOPSIS 


indxbib database ... 
lookbib [ —n | database 


DESCRIPTION 


FILES 


Indxbib makes an inverted index to the named databases (or files) for use by lookbib(1) and refer(1). 
These files contain bibliographic references (or other kinds of information) separated by blank lines. 


A bibliographic reference is a set of lines, constituting fields of bibliographic information. Each field starts 
on a line beginning with a ‘*%’’, followed by a key-letter, then a blank, and finally the contents of the field, 
which may continue until the next line starting with ‘*%’’. 


Indxbib is a shell script that calls /usr/lib/refer/mkey and /usr/lib/refer/inv. The first program, mkey, trun- 
cates words to 6 characters, and maps upper case to lower case. It also discards words shorter than 3 char- 
acters, words among the 100 most common English words, and numbers (dates) < 1900 or > 2000. These 
parameters can be changed; see page 4 of the Refer document by Mike Lesk. The second program, inv, cre- 
ates an entry file (.ia), a posting file (.ib), and a tag file (.ic), all in the working directory. 


Lookbib uses an inverted index made by indxbib to find sets of bibliographic references. It reads keywords 
typed after the ‘‘>’’ prompt on the terminal, and retrieves records containing all these keywords. If nothing 
matches, nothing is returned except another ‘‘>’’ prompt. 


Lookbib will ask if you need instructions, and will print some brief information if you reply ‘‘y’’. The 
‘‘_n’? flag turns off the prompt for instructions. 


It is possible to search multiple databases, as long as they have a common index made by indxbib. In that 
case, only the first argument given to indxbib is specified to lookbib. 


If lookbib does not find the index files (the .i[abc] files), it looks for a reference file with the same name as 
the argument, without the suffixes. It creates a file with a ’.ig’ suffix, suitable for use with fgrep. It then 
uses this fgrep file to find references. This method is simpler to use, but the .ig file is slower to use than the 
[abc] files, and does not allow the use of multiple reference files. 


x.1a, x.ib, x.ic, where x is the first argument, or if these are not present, then x.ig, x 


SEE ALSO 


BUGS 


refer(1), addbib(1), sortbib(1), roffbib(1), lookbib(1) 


Probably all dates should be indexed, since many disciplines refer to literature written in the 1800s or ear- 
lier. 
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NAME 
lorder — find ordering relation for an object library 

SYNOPSIS 
lorder file ... 

DESCRIPTION 
The input is one or more object or library archive (see ar(1)) files. The standard output is a list of pairs of 
object file names, meaning that the first file of the pair refers to external identifiers defined in the second. 
The output may be processed by tsort(1) to find an ordering of a library suitable for one-pass access by 
Id(1). 
This brash one-liner intends to build a new library from existing ‘.o’ files. 

ar cr library ~ lorder *.0 | tsort® 

The need for lorder may be vitiated by use of ranlib(1), which converts an ordered archive into a randomly 
accessed library. 

FILES 


*symref, *symdef 
nm(1), sed(1), sort(1), join(1) 


SEE ALSO 
tsort(1), 1d(1), ar(1), ranlib(1) 


BUGS 
The names of object files, in and out of libraries, must end with ‘.o’; nonsense results otherwise. 
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Ipq — spool queue examination program 


1S 
Ipg [+[n]] [-1] [—Pprinter ] [ job #... ] [ user... ] 


DESCRIPTION 


lpg examines the spooling area used by /pd(8) for printing files on the line printer, and reports the status of 
the specified jobs or all jobs associated with a user. [pg invoked without any arguments reports on any jobs 
currently in the queue. A —P flag may be used to specify a particular printer, otherwise the default line 
printer is used (or the value of the PRINTER variable in the environment). If a + argument is supplied, lpg 
displays the spool queue until it empties. Supplying a number immediately after the + sign indicates that 
lpg should sleep n seconds in between scans of the queue. All other arguments supplied are interpreted as 
user names or job numbers to filter out only those jobs of interest. 


For each job submitted (i.e. invocation of /pr(1)) [pg reports the user’s name, current rank in the queue, the 
names of files comprising the job, the job identifier (a number which may be supplied to Jprm(1) for remov- 
ing a specific job), and the total size in bytes. The -] option causes information about each of the files com- 
prising the job to be printed. Normally, only as much information as will fit on one line is displayed. Job 
ordering is dependent on the algorithm used to scan the spooling directory and is supposed to be FIFO 
(First in First Out). File names comprising a job may be unavailable (when /pr(1) is used as a sink in a 
pipeline) in which case the file is indicated as ‘‘(standard input)". 


If Jpg warns that there is no daemon present (i.e. due to some malfunction), the /pc(8) command can be 
used to restart the printer daemon. 


FILES 
/etc/termcap for manipulating the screen for repeated display 
/etc/printcap to determine printer characteristics 
/asr/spool/* the spooling directory, as determined from printcap 
/usr/spool/*/cf* control files specifying jobs 
/usr/spool/*/lock _ the lock file to obtain the currently active job 
SEE ALSO 
Ipr(1), Iprm(1), Ipe(8), Ipd(8) 
BUGS 
Due to the dynamic nature of the information in the spooling directory lpq may report unreliably. Output 
formatting is sensitive to the line length of the terminal; this can results in widely spaced columns. 
DIAGNOSTICS 


Unable to open various files. The lock file being malformed. Garbage files when there is no daemon 
active, but files in the spooling directory. 
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NAME 
Ipr — off line print 


SYNOPSIS 
Ipr [ —Pprinter | [| -#num | [-C class | [ -J job | [| -T title | | -i [ numcols ]] [ -1234 font | [ -wnum | [ 
—pltndgvecfrmhs | [ name ... | 


DESCRIPTION 
Lpr uses a spooling daemon to print the named files when facilities become available. If no names appear, 
the standard input is assumed. The —P option may be used to force output to a specific printer. Normally, 
the default printer is used (site dependent), or the value of the environment variable PRINTER is used. 


The following single letter options are used to notify the line printer spooler that the files are not standard 
text files. The spooling daemon will use the appropriate filters to print the data accordingly. 


-p _- Use pr(1) to format the files (equivalent to print). 

1 Use a filter which allows control characters to be printed and suppresses page breaks. 
-t The files are assumed to contain data from troff(1) (cat phototypesetter commands). 
-n___ The files are assumed to contain data from ditroff (device independent troff). 

-d The files are assumed to contain data from tex(1) (DVI format from Stanford). 


-g The files are assumed to contain standard plot data as produced by the plot(3X) routines (see also 
plot(1G) for the filters used by the printer spooler). 


-v__ The files are assumed to contain a raster image for devices like the Benson Varian. 
-c The files are assumed to contain data produced by cifplot(I). 


-f Use a filter which interprets the first character of each line as a standard FORTRAN carriage control 
character. 


The remaining single letter options have the following meaning. 

-r Remove the file upon completion of spooling or upon completion of printing (with the -s option). 

-m Send mail upon completion. 

-h Suppress the printing of the burst page. 

-s Use symbolic links. Usually files are copied to the spool directory. 

The —C option takes the following argument as a job classification for use on the burst page. For example, 
Ipr —-C EECS foo.c 


causes the system name (the name returned by hostname (1)) to be replaced on the burst page by EECS, and 
the file foo.c to be printed. 


The -J option takes the following argument as the job name to print on the burst page. Normally, the first 
file’s name is used. 


The -T option uses the next argument as the title used by pr(1) instead of the file name. 


To get multiple copies of output, use the -#num option, where num is the number of copies desired of each 
file named. For example, 


Ipr -#3 foo.c bar.c more.c 
would result in 3 copies of the file foo.c, followed by 3 copies of the file bar.c, etc. On the other hand, 
cat foo.c bar.c more.c | Ipr #3 


will give three copies of the concatenation of the files. 
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The -i option causes the output to be indented. If the next argument is numeric, it is used as the number of 
blanks to be printed before each line; otherwise, 8 characters are printed. 


The —w option takes the immediately following number to be the page width for pr. 


The —-s option will use symlink(2) to link data files rather than trying to copy them so large files can be 
printed. This means the files should not be modified or removed until they have been printed. 


The option —1234 Specifies a font to be mounted on font position i. The daemon will construct a .railmag 
file referencing /usr/lib/font/name.size. 


FILES 
/etc/passwd personal identification 
/etc/printcap printer capabilities data base 
/usr/lib/lpd* line printer daemons 
/usr/spool/* directories used for spooling 


/usr/spool/*/cf* daemon control files 
/usr/spool/*/df* data files specified in "cf" files 
/ust/spool/*/tf* temporary copies of "cf" files 


SEE ALSO 
Ipq(1), Iprm(1), pr(1), symlink(2), printcap(5), Ipc(8), Ipd(8) 

DIAGNOSTICS 
If you try to spool too large a file, it will be truncated. Lpr will object to printing binary files. If a user 
other than root prints a file and spooling is disabled, /pr will print a message saying so and will not put jobs 
in the queue. If a connection to /pd on the local machine cannot be made, /pr will say that the daemon can- 
not be started. Diagnostics may be printed in the daemon’s log file regarding missing spool files by /pd. 


BUGS 
Fonts for troff and tex reside on the host with the printer. It is currently not possible to use local font 
libraries. 
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NAME 

lprm — remove jobs from the line printer spooling queue 
SYNOPSIS 

Iprm [ —-Pprinter | [-][job#... ] [ user... ] 
DESCRIPTION 


Lprm will remove a job, or jobs, from a printer’s spool queue. Since the spooling directory is protected 
from users, using /prm is normally the only method by which a user may remove a job. 


Lprm without any arguments will delete the currently active job if it is owned by the user who invoked 
Iprm. 


If the - flag is specified, Jprm will remove all jobs which a user owns. If the super-user employs this flag, 
the spool queue will be emptied entirely. The owner is determined by the user’s login name and host name 
on the machine where the /pr command was invoked. 


Specifying a user’s name, or list of user names, will cause /prm to attempt to remove any jobs queued 
belonging to that user (or users). This form of invoking /prm is useful only to the super-user. 


A user may dequeue an individual job by specifying its job number. This number may be obtained from 
the /pq(1) program, e.g. 


% \pq —1 

Ist: ken [job #013ucbarpa] 
(standard input) 100 bytes 

% \prm 13 


Lprm will announce the names of any files it removes and is silent if there are no jobs in the queue which 
match the request list. 


Lprm will kill off an active daemon, if necessary, before removing any spooling files. If a daemon is killed, 
a new one is automatically restarted upon completion of file removals. 


The —P option may be usd to specify the queue associated with a specific printer (otherwise the default 
printer, or the value of the PRINTER variable in the environment is used). 


FILES 
/etc/printcap printer characteristics file 
/ust/spool/* spooling directories 
/usr/spool/*/lock lock file used to obtain the pid of the current 
daemon and the job number of the currently active job 


SEE ALSO 
Ipr(1), Ipq(1), Ipd(8) 


DIAGNOSTICS 
‘‘Permission denied" if the user tries to remove files other than his own. 


BUGS 
Since there are race conditions possible in the update of the lock file, the currently active job may be incor- 
rectly identified. 
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NAME 
Iptest — generate lineprinter ripple pattern 
SYNOPSIS 
Iptest [ length [ count | ] 
DESCRIPTION 
[ptest writes the traditional "ripple test" pattern on standard output. In 96 lines, this pattern will print all 96 


printable ASCII characters in each position. While originally created to test printers, it is quite useful for 


testing terminals, driving terminal ports for debugging purposes, or any other task where a quick supply of 
random data is needed. 


The length argument specifies the output line length if the the default length of 79 is inappropriate. 


The count argument specifies the number of output lines to be generated if the default count of 200 is inap- 
propriate. Note that if count is to be specified, Jength must be also be specified. 


SEE ALSO 
BUGS 
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NAME 
ls — list contents of directory 


SYNOPSIS 
Is [| -acdfgilqrstul1ACLFR ] name ... 


DESCRIPTION 
For each directory argument, /s lists the contents of the directory; for each file argument, /s repeats its name 
and any other information requested. By default, the output is sorted alphabetically. When no argument is 
given, the current directory is listed. When several arguments are given, the arguments are first sorted 
appropriately, but file arguments are processed before directories and their contents. 


There are a large number of options: 


-l List in long format, giving mode, number of links, owner, size in bytes, and time of last 
modification for each file. (See below.) If the file is a special file the size field will instead contain 
the major and minor device numbers. If the file is a symbolic link the pathname of the linked-to 
file is printed preceded by ‘‘—>’’. 


-g Include the group ownership of the file in a long output. 

-t Sort by time modified (latest first) instead of by name. 

-a List all entries; in the absence of this option, entries whose names begin with a period (.) are not 
listed. 

-s Give size in kilobytes of each file. 

-d If argument is a directory, list only its name; often used with —I to get the status of a directory. 

-L If argument is a symbolic link, list the file or directory the link references rather than the link 
itself. 

-r Reverse the order of sort to get reverse alphabetic or oldest first as appropriate. 

-u Use time of last access instead of last modification for sorting (with the -t option) and/or printing 


(with the -I option). 


— Use time of file creation for sorting or printing. 
-i For each file, print the i-number in the first column of the report. 
-f Force each argument to be interpreted as a directory and list the name found in each slot. This 


option turns off -l, -t, -s, and -r, and turns on —a; the order is the order in which entries appear in 
the directory. 


-F cause directories to be marked with a trailing ‘/’, sockets with a trailing ‘=’, symbolic links with a 
trailing “@’, and executable files with a trailing ‘*’. 


-R recursively list subdirectories encountered. 

-1 force one entry per line output format; this is the default when output is not to a terminal. 

-C force multi-column output; this is the default when output is to a terminal. 

-q force printing of non-graphic characters in file names as the character ‘?’; this is the default when 


output is to a terminal. 


The mode printed under the -] option contains 11 characters which are interpreted as follows: the first char- 
acter is 


d_ if the entry is a directory; 

b_ if the entry is a block-type special file; 
cif the entry is a character-type special file; 
1 if the entry is a symbolic link; 
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s if the entry is a socket, or 
— if the entry is a plain file. 


The next 9 characters are interpreted as three sets of three bits each. The first set refers to owner permis- 
sions; the next refers to permissions to others in the same user-group; and the last to all others. Within each 
set the three characters indicate permission respectively to read, to write, or to execute the file as a program. 
For a directory, ‘execute’ permission is interpreted to mean permission to search the directory. The permis- 
sions are indicated as follows: 


r_ if the file is readable; 

w if the file is writable; 

x if the file is executable; 

— if the indicated permission is not granted. 


The group-execute permission character is given as s if the file has the set-group-id bit set; likewise the 
user-execute permission character is given as s if the file has the set-user-id bit set. 


The last character of the mode (normally ‘x’ or ‘—’) is t if the 1000 bit of the mode is on. See chmod(1) for 
the meaning of this mode. 


When the sizes of the files in a directory are listed, a total count of blocks, including indirect blocks is 
printed. 


/etc/passwd to get user id’s for ‘Is -l’. 
/etc/group to get group id’s for ‘Is -g’. 


Newline and tab are considered printing characters in file names. 
The output device is assumed to be 80 columns wide. 


The option setting based on whether the output is a teletype is undesirable as ‘‘Is -s’’ is much different than 
“Is —s | Ipr’’. On the other hand, not doing this setting would make old shell scripts which used /s almost 
certain losers. 
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NAME 


Ixref — lisp cross reference program 


SYNOPSIS 


Ixref [ —N ] xref-file ... [ —a source-file ... ] 


DESCRIPTION 


Lxref reads cross reference file(s) written by the lisp compiler /iszt and prints a cross reference listing on the 
standard output. Liszt will create a cross reference file during compilation when it is given the —x switch. 
Cross reference files usually end in ‘.x’ and consequently /xref will append a ‘.x’ to the file names given if 
necessary. The first option to /xref is a decimal integer, N, which sets the ignorelevel. If a function is called 
more than ignorelevel times, the cross reference listing will just print the number of calls instead of listing 
each one of them. The default for ignorelevel is 50. 


The —a option causes /xref to put limited cross reference information in the sources named. /xref will scan 
the source and when it comes across a definition of a function (that is a line beginning with ‘(def it will 
preceed that line with a list of the functions which call this function, written as a comment preceeded by ‘;.. 
’. All existing lines beginning with ‘;.. ’ will be removed from the file. If the source file contains a line 
beginning ‘;.-’ then this will disable this annotation process from this point on until a ‘;.+’ is seen (how- 
ever, lines beginning with ‘;.. ’ will continue to be deleted). After the annoation is done, the original file 
‘foo.’ is renamed to " %#,foo.l’" and the new file with annotation is named ‘foo.l’ 


AUTHOR 


John Foderaro 


SEE ALSO 


BUGS 


lisp(1), liszt(1) 


4th Berkeley Distribution April 29, 1985 1 


M4(1) 


NAME 


UNIX Programmer’s Manual M4(1) 


m4 — macro processor 


SYNOPSIS 


m4 [ files ] 


DESCRIPTION 


M4 is a macro processor intended as a front end for Ratfor, C, and other languages. Each of the argument 
files is processed in order; if there are no arguments, or if an argument is “—’, the standard input is read. 
The processed text is written on the standard output. 


Macro calls have the form 
name(arg1,arg2, ..., argn) 


The ‘( must immediately follow the name of the macro. If a defined macro name is not followed by a ‘(’, it 
is deemed to have no arguments. Leading unquoted blanks, tabs, and newlines are ignored while collecting 
arguments. Potential macro names consist of alphabetic letters, digits, and underscore ‘ ’, where the first 
character is not a digit. 


Left and right single quotes ( *) are used to quote strings. The value of a quoted string is the string stripped 
of the quotes. 


When a macro name is recognized, its arguments are collected by searching for a matching right parenthe- 
sis. Macro evaluation proceeds normally during the collection of the arguments, and any commas or right 
parentheses which happen to turn up within the value of a nested call are as effective as those in the original 
input text. After argument collection, the value of the macro is pushed back onto the input stream and res- 
canned. 


M4 makes available the following built-in macros. They may be redefined, but once this is done the origi- 
nal meaning is lost. Their values are null unless otherwise stated. 


define The second argument is installed as the value of the macro whose name is the first argument. 
Each occurrence of $n in the replacement text, where n is a digit, is replaced by the n-th argu- 
ment. Argument 0 is the name of the macro; missing arguments are replaced by the null string. 


undefine removes the definition of the macro named in its argument. 


ifdef If the first argument is defined, the value is the second argument, otherwise the third. If there is 
no third argument, the value is null. The word unix is predefined on UNIX versions of m4. 


changequote 
Change quote characters to the first and second arguments. Changequote without arguments 
restores the original values (i.e., ~ *). 


divert M4 maintains 10 output streams, numbered 0-9. The final output is the concatenation of the 
streams in numerical order; initially stream 0 is the current stream. The divert macro changes 
the current output stream to its (digit-string) argument. Output diverted to a stream other than 
0 through 9 is discarded. 


undivert causes immediate output of text from diversions named as arguments, or all diversions if no 
argument. Text may be undiverted into another diversion. Undiverting discards the diverted 
text. 


divnum returns the value of the current output stream. 
dnl reads and discards characters up to and including the next newline. 


ifelse has three or more arguments. If the first argument is the same string as the second, then the 
value is the third argument. If not, and if there are more than four arguments, the process is 
repeated with arguments 4, 5, 6 and 7. Otherwise, the value is either the fourth string, or, if it 
is not present, null. 
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incr 


eval 


len 


index 


substr 


translit 


include 

sinclude 

syscmd 

maketemp 

errprint 

dumpdef 
SEE ALSO 
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returns the value of its argument incremented by 1. The value of the argument is calculated by 
interpreting an initial digit-string as a decimal number. 


evaluates its argument as an arithmetic expression, using 32-bit arithmetic. Operators include 
+, —, *, /, %, * (exponentiation); relationals; parentheses. 


returns the number of characters in its argument. 


returns the position in its first argument where the second argument begins (zero origin), or —1 
if the second argument does not occur. 


returns a substring of its first argument. The second argument is a zero origin number selecting 
the first character; the third argument indicates the length of the substring. A missing third 
argument is taken to be large enough to extend to the end of the first string. 


transliterates the characters in its first argument from the set given by the second argument to 
the set given by the third. No abbreviations are permitted. 


returns the contents of the file named in the argument. 

is identical to include, except that it says nothing if the file is inaccessible. 
executes the UNIX command given in the first argument. No value is returned. 
fills in a string of XXX XX in its argument with the current process id. 

prints its argument on the diagnostic output file. 


prints current names and definitions, for the named items, or for all if no arguments are given. 


B. W. Kernighan and D. M. Ritchie, The M4 Macro Processor 
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NAME 
mail — send and receive mail 


SYNOPSIS 
mail [ -v ] [-i ] [-n ] [-s subject ] [ user... ] 
mail [ -v ] [-i] [-n ] -f [ name ] 
mail [ —v ] [ -i ] [ —n ] —u user 


INTRODUCTION 
Mail is a intelligent mail processing system, which has a command syntax reminiscent of ed with lines 
replaced by messages. 


The —v flag puts mail into verbose mode; the details of delivery are displayed on the users terminal. The -i 
flag causes tty interrupt signals to be ignored. This is particularly useful when using mail on noisy phone 
lines. The -n flag inhibits the reading of /usr/lib/Mail.rc. 


Sending mail. To send a message to one or more people, mail can be invoked with arguments which are the 
names of people to whom the mail will be sent. You are then expected to type in your message, followed 
by an EOT (control—D) at the beginning of a line. A subject may be specified on the command line by using 
the -s flag. (Only the first argument after the -s flag is used as a subject; be careful to quote subjects con- 
taining spaces.) The section below, labeled Replying to or originating mail, describes some features of 
mail available to help you compose your letter. 


Reading mail. In normal usage mail is given no arguments and checks your mail out of the post office, then 
prints out a one line header of each message there. The current message is initially the first message (num- 
bered 1) and can be printed using the print command (which can be abbreviated p). You can move among 
the messages much as you move between lines in ed, with the commands ‘+’ and “—’ moving backwards 
and forwards, and simple numbers. 


Disposing of mail. After examining a message you can delete (d) the message or reply (r) to it. Deletion 
causes the mail program to forget about the message. This is not irreversible; the message can be 
undeleted (u) by giving its number, or the mail session can be aborted by giving the exit (x) command. 
Deleted messages will, however, usually disappear never to be seen again. 


Specifying messages. Commands such as print and delete can be given a list of message numbers as argu- 
ments to apply to a number of messages at once. Thus ‘“‘delete 1 2’’ deletes messages | and 2, while 
‘‘delete 1-5’’ deletes messages 1 through 5. The special name ‘‘*’’ addresses all messages, and ‘‘$”’ 
addresses the last message; thus the command top which prints the first few lines of a message could be 
used in ‘‘top *’’ to print the first few lines of all messages. 


Replying to or originating mail. You can use the reply command to set up a response to a message, send- 
ing it back to the person who it was from. Text you then type in, up to an end-of-file, defines the contents 
of the message. While you are composing a message, mail treats lines beginning with the character “’ spe- 
cially. For instance, typing ‘““m’’ (alone on a line) will place a copy of the current message into the 
response right shifting it by a tabstop. Other escapes will set up subject fields, add and delete recipients to 
the message and allow you to escape to an editor to revise the message or to a shell to run some commands. 
(These options are given in the summary below.) 


Ending a mail processing session. You can end a mail session with the quit (q) command. Messages 
which have been examined go to your mbox file unless they have been deleted in which case they are dis- 
carded. Unexamined messages go back to the post office. The -f option causes mail to read in the contents 
of your mbox (or the specified file) for processing; when you quit, mail writes undeleted messages back to 
this file. The -u flag is a short way of doing "mail -f /usr/spool/mail/user". 


Personal and systemwide distribution lists. It is also possible to create a personal distribution lists so that, 
for instance, you can send mail to ‘‘cohorts’’ and have it go to a group of people. Such lists can be defined 
by placing a line like 
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alias cohorts bill ozalp jkf mark kridle@ucbcory 


in the file .mailrc in your home directory. The current list of such aliases can be displayed with the alias (a) 
command in mail. System wide distribution lists can be created by editing /usr/lib/aliases, see aliases(5) 
and sendmail(8); these are kept in a different syntax. In mail you send, personal aliases will be expanded in 
mail sent to others so that they will be able to reply to the recipients. System wide aliases are not 
expanded when the mail is sent, but any reply returned to the machine will have the system wide alias 
expanded as all mail goes through sendmail. 


Network mail (ARPA, UUCP, Berknet) See mailaddr(7) for a description of network addresses. 


Mail has a number of options which can be set in the .mailrc file to alter its behavior; thus ‘‘set askcc’’ 
enables the ‘‘askcc’’ feature. (These options are summarized below.) 


SUMMARY 
(Adapted from the ‘Mail Reference Manual’) 


Each command is typed on a line by itself, and may take arguments following the command word. The 
command need not be typed in its entirety — the first command which matches the typed prefix is used. For 
commands which take message lists as arguments, if no message list is given, then the next message for- 
ward which satisfies the command’s requirements is used. If there are no messages forward of the current 
message, the search proceeds backwards, and if there are no good messages at all, mail types “‘No applica- 
ble messages’’ and aborts the command. 


- Goes to the previous message and prints it out. If given a numeric argument n, goes to the 
n-th previous message and prints it. 


? Prints a brief summary of commands. 

! Executes the UNIX shell command which follows. 

Print (P) Like print but also prints out ignored header fields. See also print , ignore and retain. 
Reply (R) Reply to originator. Does not reply to other recipients of the original message. 

Type (T) Identical to the Print command. 

alias (a) With no arguments, prints out all currently-defined aliases. With one argument, prints 


out that alias. With more than one argument, creates an new or changes an on old alias. 


alternates (alt) The alternates command is useful if you have accounts on several machines. It can be 
used to inform mail that the listed addresses are really you. When you reply to messages, 
mail will not send a copy of the message to any of the addresses listed on the alternates list. 
If the alternates command is given with no argument, the current set of alternate names is 
displayed. 


chdir (c) Changes the user’s working directory to that specified, if given. If no directory is given, 
then changes to the user’s login directory. 


copy (co) The copy command does the same thing that save does, except that it does not mark the 
messages it is used on for deletion when you quit. 


delete (d) Takes a list of messages as argument and marks them all as deleted. Deleted messages 
will not be saved in mbox, nor will they be available for most other commands. 


dp (also dt) Deletes the current message and prints the next message. If there is no next mes- 
sage, mail says ‘‘at EOF.” 


edit (e) Takes a list of messages and points the text editor at each one in turn. On return from the 
editor, the message is read back in. 


exit (ex or x) Effects an immediate return to the Shell without modifying the user’s system mail- 
box, his mbox file, or his edit file in -f. 
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file 
folders 
folder 


from 


headers 


help 


hold 


ignore 


mail 


mbox 


next 


preserve 
print 


quit 


reply 


respond 


retain 


Save 
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(fi) The same as folder. 
List the names of the folders in your folder directory. 


(fo) The folder command switches to a new mail file or folder. With no arguments, it tells 
you which file you are currently reading. If you give it an argument, it will write out 
changes (such as deletions) you have made in the current file and read in the new file. Some 
special conventions are recognized for the name. # means the previous file, % means your 
system mailbox, %user means user’s system mailbox, & means your ~/mbox file, and 
+folder means a file in your folder directory. 


(f) Takes a list of messages and prints their message headers. 


(h) Lists the current range of headers, which is an 18 message group. If a “‘+’’ argument is 
given, then the next 18 message group is printed, and if a ‘‘“—’’ argument is given, the previ- 
ous 18 message group is printed. 


A synonym for ? 


(ho, also preserve) Takes a message list and marks each message therein to be saved in the 
user’s system mailbox instead of in mbox. Does not override the delete command. 


N.B.: Ignore has been superseded by retain. 

Add the list of header fields named to the ignored list. Header fields in the ignore list are 
not printed on your terminal when you print a message. This command is very handy for 
suppression of certain machine-generated header fields. The Type and Print commands can 
be used to print a message in its entirety, including ignored fields. If ignore is executed with 
no arguments, it lists the current set of ignored fields. 


(m) Takes as argument login names and distribution group names and sends mail to those 
people. 


Indicate that a list of messages be sent to mbox in your home directory when you quit. This 
is the default action for messages if you do not have the hold option set. 


(n like + or CR) Goes to the next message in sequence and types it. With an argument list, 
types the next matching message. 


(pre) A synonym for hold. 
(p) Takes a message list and types out each message on the user’s terminal. 


(q) Terminates the session, saving all undeleted, unsaved messages in the user’s mbox file in 
his login directory, preserving all messages marked with hold or preserve or never refer- 
enced in his system mailbox, and removing all other messages from his system mailbox. If 
new mail has arrived during the session, the message “‘You have new mail’’ is given. If 
given while editing a mailbox file with the -f flag, then the edit file is rewritten. A return to 
the Shell is effected, unless the rewrite of edit file fails, in which case the user can escape 
with the exit command. 


(r) Takes a message list and sends mail to the sender and all recipients of the specified mes- 
sage. The default message must not be deleted. 


A synonym for reply. 


Add the list of header fields named to the retained list. Only the header fields in the retain 
list are shown on your terminal when you print a message. All other header fields are sup- 
pressed. The Type and Print commands can be used to print a message in its entirety. If 
retain is executed with no arguments, it lists the current set of retained fields. 


(s) Takes a message list and a filename and appends each message in turn to the end of the 
file. The filename in quotes, followed by the line count and character count is echoed on the 
user’s terminal. 
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(se) With no arguments, prints all variable values. Otherwise, sets option. Arguments are of 
the form ‘‘option=value’’ (no space before or after =) or ‘‘option.’’ 


(sh) Invokes an interactive version of the shell. 
Takes a message list and prints out the size in characters of each message. 
(so) The source command reads mail commands from a file. 


Takes a message list and prints the top few lines of each. The number of lines printed is 
controlled by the variable toplines and defaults to five. 


(t) A synonym for print. 


Takes a list of names defined by alias commands and discards the remembered groups of 
users. The group names no longer have any significance. 


(u) Takes a message list and marks each message as not being deleted. 

(U) Takes a message list and marks each message as not having been read. 

Takes a list of option names and discards their remembered values; the inverse of set. 
(v) Takes a message list and invokes the display editor on each message. 


(w) Similar to save, except that only the message body (without the header) is saved. 
Extremely useful for such tasks as sending and receiving source program text over the mes- 
sage system. 


(x) A synonym for exit. 


Mail presents message headers in windowfuls as described under the headers command. 
You can move mail’s attention forward to the next window with the z command. Also, you 
can move to the previous window by using z-. 


Here is a summary of the tilde escapes, which are used when composing messages to perform special func- 
tions. Tilde escapes are only recognized at the beginning of lines. The name “‘tilde escape’’ is somewhat 
of a misnomer since the actual escape character can be set by the option escape. 


“command 


“~b name ... 


“c name... 
“d 


e 


“f messages 


“h 


“m messages 


“Pp 


q 


“r filename 


Execute the indicated shell command, then return to the message. 


Add the given names to the list of carbon copy recipients but do not make the names visible 
in the Cc: line ("blind" carbon copy). 


Add the given names to the list of carbon copy recipients. 
Read the file ‘‘dead.letter’’ from your home directory into the message. 


Invoke the text editor on the message collected so far. After the editing session is finished, 
you may continue appending text to the message. 


Read the named messages into the message being sent. If no messages are specified, read in 
the current message. 


Edit the message header fields by typing each one in turn and allowing the user to append 
text to the end or modify the field by using the current terminal erase and kill characters. 


Read the named messages into the message being sent, shifted right one tab. If no messages 
are specified, read the current message. 


Print out the message collected so far, prefaced by the message header fields. 


Abort the message being sent, copying the message to “‘dead.letter’’ in your home directory 
if save is set. 


Read the named file into the message. 
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“s string 
“tname ... 


v 


“w filename 


os | command 


“string 
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Cause the named string to become the current subject field. 
Add the given names to the direct recipient list. 


Invoke an alternate editor (defined by the VISUAL option) on the message collected so far. 
Usually, the alternate editor will be a screen editor. After you quit the editor, you may 
resume appending text to the end of your message. 


Write the message onto the named file. 


Pipe the message through the command as a filter. If the command gives no output or termi- 
nates abnormally, retain the original text of the message. The command fmf(1) is often used 
as command to rejustify the message. 


Insert the string of text in the message prefaced by a single ~. If you have changed the 
escape character, then you should double that character in order to send it. 


Options are controlled via the set and unset commands. Options may be either binary, in which case it is 
only significant to see whether they are set or not; or string, in which case the actual value is of interest. 
The binary options include the following: 


append 


ask 


askcc 


autoprint 


debug 


dot 


hold 
ignore 


ignoreeof 


metoo 


nosave 


Replyall 


quiet 


verbose 


Causes messages saved in mbox to be appended to the end rather than prepended. (This 
is set in /usr/lib/Mail.rc on version 7 systems.) 


Causes mail to prompt you for the subject of each message you send. If you respond 
with simply a newline, no subject field will be sent. 


Causes you to be prompted for additional carbon copy recipients at the end of each mes- 
sage. Responding with a newline indicates your satisfaction with the current list. 


Causes the delete command to behave like dp — thus, after deleting a message, the next 
one will be typed automatically. 


Setting the binary option debug is the same as specifying —-d on the command line and 
causes mail to output all sorts of information useful for debugging mail. 


The binary option dot causes mail to interpret a period alone on a line as the terminator 
of a message you are sending. 


This option is used to hold messages in the system mailbox by default. 
Causes interrupt signals from your terminal to be ignored and echoed as @’s. 


An option related to dot is ignoreeof which makes mail refuse to accept a control-d as 
the end of a message. Ignoreeof also applies to mail command mode. 


Usually, when a group is expanded that contains the sender, the sender is removed from 
the expansion. Setting this option causes the sender to be included in the group. 


Normally, when you abort a message with two RUBOUT, mail copies the partial letter to 
the file “‘dead.letter’’ in your home directory. Setting the binary option nosave prevents 
this. 


Reverses the sense of reply and Reply commands. 
Suppresses the printing of the version when first invoked. 


Setting the option verbose is the same as using the —v flag on the command line. When 
mail runs in verbose mode, the actual delivery of messages is displayed on he users ter- 
minal. 


The following options have string values: 


EDITOR 


Pathname of the text editor to use in the edit command and “e escape. If not defined, 
then a default editor is used. 
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PAGER 


SHELL 


VISUAL 


crt 


escape 


folder 


record 


toplines 


FILES 
/usr/spool/mail/* 
~/mbox 
“~/-mailrce 
/tmp/R# 
/ust/lib/Mail.help* 
/ust/lib/Mail.rc 
Message* 


SEE ALSO 


binmail(1), fmt(1), 
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Pathname of the program to use in the more command or when crt variable is set. A 
default paginator is used if this option is not defined. 


Pathname of the shell to use in the ! command and the ~! escape. A default shell is used 
if this option is not defined. 


Pathname of the text editor to use in the visual command and ~v escape. 


The valued option crt is used as a threshold to determine how long a message must be 
before PAGER is used to read it. 


If defined, the first character of this option gives the character to use in the place of ~ to 
denote escapes. 


The name of the directory to use for storing folders of messages. If this name begins with 
a ‘/’, mail considers it to be an absolute pathname; otherwise, the folder directory is 
found relative to your home directory. 


If defined, gives the pathname of the file used to record all outgoing mail. If not defined, 
then outgoing mail is not so saved. 


If defined, gives the number of lines of a message to be printed out with the top com- 
mand; normally, the first five lines are printed. 


post office 

your old mail 

file giving initial mail commands 
temporary for editor escape 

help files 

system initialization file 
temporary for editing messages 


newaliases(1), aliases(5), 


mailaddr(7), sendmail(8) 


‘The Mail Referen 
BUGS 


ce Manual’ 


There are many flags that are not documented here. Most are not useful to the general user. 
Usually, mail is just a link to Mail, which can be confusing. 


AUTHOR 
Kurt Shoens 
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NAME 
make — maintain program groups 


SYNOPSIS 
make [ -f makefile ] [ option ] ... file ... 


DESCRIPTION 
Make executes commands in makefile to update one or more target names. Name is typically a program. If 
no -f option is present, ‘makefile’ and ‘Makefile’ are tried in order. If makefile is ‘—’, the standard input is 
taken. More than one -f option may appear. 


Make updates a target if it depends on prerequisite files that have been modified since the target was last 
modified, or if the target does not exist. 


Makefile contains a sequence of entries that specify dependencies. The first line of an entry is a blank- 
separated list of targets, then a colon, then a list of prerequisite files. Text following a semicolon, and all 
following lines that begin with a tab, are shell commands to be executed to update the target. If a name 
appears on the left of more than one ‘colon’ line, then it depends on all of the names on the right of the 
colon on those lines, but only one command sequence may be specified for it. If a name appears on a line 
with a double colon :: then the command sequence following that line is performed only if the name is out 
of date with respect to the names to the right of the double colon, and is not affected by other double colon 
lines on which that name may appear. 


Two special forms of a name are recognized. A name like a(b) means the file named b stored in the 
archive named a. A name like a((b)) means the file stored in archive a containing the entry point b. 


Sharp and newline surround comments. 


The following makefile says that ‘pgm’ depends on two files ‘a.o’ and ‘b.o’, and that they in turn depend on 
“.c’ files and a common file ‘incl’. 


pgm: a.o b.o 

cc a.o b.o-Im —-0 pgm 
a.o: incl a.c 

cc —C a.c 
b.o: incl b.c 

cc —c b.c 


Makefile entries of the form 

string] = string2 
are macro definitions. Subsequent appearances of $(string/) or ${string]} are replaced by string2. If 
string] is a single character, the parentheses or braces are optional. 


Make infers prerequisites for files for which makefile gives no construction commands. For example, a *.c’ 
file may be inferred as prerequisite for a ‘.o’ file and be compiled to produce the ‘.o’ file. Thus the preced- 
ing example can be done more briefly: 


pgm: a.o b.o 
cc a.o b.o -Im -0 pgm 
a.o b.o: incl 


Prerequisites are inferred according to selected suffixes listed as the ‘prerequisites’ for the special name 
‘.SUFFIXES’; multiple lists accumulate; an empty list clears what came before. Order is significant; the 
first possible name for which both a file and a rule as described in the next paragraph exist is inferred. The 
default list is 


-SUFFIXES: .out .o .c .e .r f.y 1.8 .p 
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FILES 


The rule to create a file with suffix s2 that depends on a similarly named file with suffix s/ is specified as an 
entry for the ‘target’ s/s2. In such an entry, the special macro $* stands for the target name with suffix 
deleted, $@ for the full target name, $< for the complete list of prerequisites, and $? for the list of prerequi- 
sites that are out of date. For example, a rule for making optimized *‘.o’ files from ‘.c’ files is 


.c.0: ;cc C—O -0 $@ $.c 


Certain macros are used by the default inference rules to communicate optional arguments to any resulting 
compilations. In particular, ‘CFLAGS’ is used for cc(1) options, “FFLAGS’ for f77(1) options, “PFLAGS’ 
for pc(1) options, and ‘LFLAGS’ and ‘YFLAGS’ for lex and yacc(1) options. In addition, the macro 
‘MFLAGS?’ is filled in with the initial command line options supplied to make. This simplifies maintaining 
a hierarchy of makefiles as one may then invoke make on makefiles in subdirectories and pass along useful 
options such as —-k. 


Another special macro is ‘VPATH’. The ‘VPATH’ macro should be set to a list of directories separated by 
colons. When make searches for a file as a result of a dependency relation, it will first search the current 
directory and then each of the directories on the ‘VPATH?’ list. If the file is found, the actual path to the file 
will be used, rather than just the filename. If ‘VPATH’ is not defined, then only the current directory is 
searched. 


One use for “VPATH’ is when one has several programs that compile from the same source. The source 
can be kept in one directory and each set of object files (along with a separate makefile) would be in a sepa- 
rate subdirectory. The ‘VPATH’ macro would point to the source directory in this case. 


Command lines are executed one at a time, each by its own shell. A line is printed when it is executed 
unless the special target ‘.SILENT” is in makefile, or the first character of the command is *‘@’. 


Commands returning nonzero status (see intro(1)) cause make to terminate unless the special target 
“ IGNORE’ is in makefile or the command begins with <tab><hyphen>. 


Interrupt and quit cause the target to be deleted unless the target is a directory or depends on the special 
name ‘.PRECIOUS’. 


Other options: 
-i Equivalent to the special entry “.IGNORE:’. 


-k When a command returns nonzero status, abandon work on the current entry, but continue on 
branches that do not depend on the current entry. 


—n Trace and print, but do not execute the commands needed to update the targets. 
-t Touch, i.e. update the modified date of targets, without executing any commands. 
-r Equivalent to an initial special entry ‘.SUFFIXES:’ with no list. 

-s Equivalent to the special entry *“.SILENT:’. 


makefile, Makefile 


SEE ALSO 


BUGS 


sh(1), touch(1), £771), pe(1) 
S. IL Feldman Make — A Program for Maintaining Computer Programs 


Some commands return nonzero status inappropriately. Use -i to overcome the difficulty. 
Commands that are directly executed by the shell, notably cd(1), are ineffectual across newlines in make. 


“VPATH?’ is intended to act like the System V “VPATH’ support, but there is no guarantee that it functions 
identically. 
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NAME 
man — find manual information by keywords; print out the manual 

SYNOPSIS 
man [ - ] [-M path | [ section ] title ... 
man —-k keyword ... 
man -f file ... 

DESCRIPTION 
Man is a program which gives information from the programmers manual. It can be asked for one line 
descriptions of commands specified by name, or for all commands whose description contains any of a set 
of keywords. It can also provide on-line access to the sections of the printed manual. 
When given the option -k and a set of keywords, man prints out a one line synopsis of each manual sec- 
tions whose listing in the table of contents contains one of those keywords. 
When given the option -f and a list of file names, man attempts to locate manual sections related to those 
files, printing out the table of contents lines for those sections. 
When neither -k nor -f is specified, man formats a specified set of manual pages. If a section specifier is 
given man looks in the that section of the manual for the given titles. Section is either an Arabic section 
number (3 for instance), or one of the words ‘‘new,”’ ‘‘local,’’ ‘‘old,’’ or ‘‘public.’’ A section number may 
be followed by a single letter classifier (for instance, 1g, indicating a graphics program in section 1). If sec- 
tion is omitted, man searches all sections of the manual, giving preference to commands over subroutines in 
system libraries, and printing the first section it finds, if any. 
If the standard output is a teletype, or if the flag — is given, man pipes its output through more(1) with the 
option —s to crush out useless blank lines and to stop after each page on the screen. Hit a space to continue, 
a control-D to scroll 11 more lines when the output stops. 
Normally man checks in a standard location for manual information (/usr/man). This can be changed by 
supplying a search path (a la the shell) with the -M flag. The search path is a colon (‘:’) separated list of 
directories in which manual subdirectories may be found; e.g. ‘‘/usr/local:/usr/man’’. If the environment 
variable ‘MANPATH? is set, its value is used for the default path. If a search path is supplied with the -k 
or -f options, it must be specified first. 
Man will look for the manual page in either of two forms, the nroff source or preformatted pages. If either 
version is available, the manual page will be displayed. If the preformatted version is available, and it has a 
more recent modify time than the nroff source, it will be promptly displayed. Otherwise, the manual page 
will be formatted with nroff and displayed. If the user has permission, the formatted manual page will be 
deposited in the proper place, so that later invocations of man will not need to format the page again. 

FILES 
/usr/man standard manual area 
/usr/man/man?/* directories containing source for manuals 
/usr/man/cat?/* directories containing preformatted pages 
/usr/man/whatis keyword database 

SEE ALSO 
apropos(1), more(1), whereis(1), catman(8) 

BUGS 


The manual is supposed to be reproducible either on the phototypesetter or on a typewriter. However, on a 
typewriter some information is necessarily lost. 
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NAME 
mesg — permit or deny messages 


SYNOPSIS 
mesg[n][y] 


DESCRIPTION 
Mesg with argument n forbids messages via write and talk(1) by revoking non-user write permission on the 
user’s terminal. Mesg with argument y reinstates permission. All by itself, mesg reports the current state 
without changing it. 

FILES 
/dev/tty* 


SEE ALSO 
write(1), talk(1) 


DIAGNOSTICS 
Exit status is 0 if messages are receivable, | if not, 2 on error. 
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NAME 
mkdir — make a directory 


SYNOPSIS 
mkdir dirname ... 


DESCRIPTION 
Mkdir creates specified directories in mode 777. Standard entries, ‘.’, for the directory itself, and ‘..’ for its 


parent, are made automatically. 
Mkdir requires write permission in the parent directory. 


SEE ALSO 
rmdir(1) 
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NAME 


mkstr — create an error message file by massaging C source 


SYNOPSIS 


mkstr [ — ] messagefile prefix file ... 


DESCRIPTION 


Mkstr is used to create files of error messages. Its use can make programs with large numbers of error diag- 
nostics much smaller, and reduce system overhead in running the program as the error messages do not 
have to be constantly swapped in and out. 


Mkstr will process each of the specified files, placing a massaged version of the input file in a file whose 
name consists of the specified prefix and the original name. A typical usage of mkstr would be 


mkstr pistrings xx *.c 


This command would cause all the error messages from the C source files in the current directory to be 
placed in the file pistrings and processed copies of the source for these files to be placed in files whose 
names are prefixed with xx. 


mo 


To process the error messages in the source to the message file mkstr keys on the string ‘error("’ in the 
input stream. Each time it occurs, the C string starting at the ‘"’ is placed in the message file followed by a 
null character and a new-line character; the null character terminates the message so it can be easily used 
when retrieved, the new-line character makes it possible to sensibly cat the error message file to see its con- 
tents. The massaged copy of the input file then contains a /seek pointer into the file which can be used to 
retrieve the message, i.e.: 


char — efilname[] = "/usr/lib/pi_ strings"; 
int efil = -1; 


error(al, a2, a3, a4) 


{ 
char buf[256]; 


if (efil < 0) { 
efil = open(efilname, 0); 
if (efil < 0) { 
oops: 
perror(efilname); 
exit(1); 


} 


} 
if (Iseek(efil, (long) al, 0) | | read(efil, buf, 256) <= 0) 
goto oops; 
printf(buf, a2, a3, a4); 
} 


The optional — causes the error messages to be placed at the end of the specified message file for recompil- 
ing part of a large mkstr ed program. 


SEE ALSO 


lseek(2), xstr(1) 
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NAME 


more, page — file perusal filter for crt viewing 


SYNOPSIS 


more [ -cdflsu ] [ -n ] [ +/inenumber ] [ +/pattern |[ name... ] 


page more options 


DESCRIPTION 


More is a filter which allows examination of a continuous text one screenful at a time on a soft-copy termi- 
nal. It normally pauses after each screenful, printing --More-- at the bottom of the screen. If the user then 
types a carriage return, one more line is displayed. If the user hits a space, another screenful is displayed. 
Other possibilities are enumerated later. 


The command line options are: 
—n An integer which is the size (in lines) of the window which more will use instead of the default. 


— More will draw each page by beginning at the top of the screen and erasing each line just before it 
draws on it. This avoids scrolling the screen, making it easier to read while more is writing. This 
option will be ignored if the terminal does not have the ability to clear to the end of a line. 


-d More will prompt the user with the message "Press space to continue, “q’ to quit." at the end of 
each screenful, and will respond to subsequent illegal user input by printing "Press “h’ for instruc- 
tions." instead of ringing the bell. This is useful if more is being used as a filter in some setting, 
such as a class, where many users may be unsophisticated. 


-f This causes more to count logical, rather than screen lines. That is, long lines are not folded. This 
option is recommended if nroff output is being piped through wi, since the latter may generate 
escape sequences. These escape sequences contain characters which would ordinarily occupy 
screen positions, but which do not print when they are sent to the terminal as part of an escape 
sequence. Thus more may think that lines are longer than they actually are, and fold lines erro- 
neously. 


4 Do not treat “L (form feed) specially. If this option is not given, more will pause after any line that 
contains a “L, as if the end of a screenful had been reached. Also, if a file begins with a form feed, 
the screen will be cleared before the file is printed. 


Ss Squeeze multiple blank lines from the output, producing only one blank line. Especially helpful 
when viewing nroff output, this option maximizes the useful information present on the screen. 


-u Normally, more will handle underlining such as produced by nroff in a manner appropriate to the 
particular terminal: if the terminal can perform underlining or has a stand-out mode, more will 
output appropriate escape sequences to enable underlining or stand-out mode for underlined infor- 
mation in the source file. The —uv option suppresses this processing. 


+linenumber 
Start up at linenumber. 


+/pattern 
Start up two lines before the line containing the regular expression pattern. 


If the program is invoked as page, then the screen is cleared before each screenful is printed (but only if a 
full screenful is being printed), and k — 1 rather than k — 2 lines are printed in each screenful, where k is the 
number of lines the terminal can display. 


More \ooks in the file /etc/termcap to determine terminal characteristics, and to determine the default win- 
dow size. On a terminal capable of displaying 24 lines, the default window size is 22 lines. 


More \ooks in the environment variable MORE to pre-set any flags desired. For example, if you prefer to 
view files using the —c mode of operation, the csh command setenv MORE -c or the sh command sequence 
MORE=’-c’ ; export MORE would cause all invocations of more , including invocations by programs such 


4th Berkeley Distribution June 5, 1986 1 


MORE (1) UNIX Programmer’s Manual MORE(1) 


as man and msgs , to use this mode. Normally, the user will place the command sequence which sets up the 
MORE environment variable in the .cshrc or .profile file. 


If more is reading from a file, rather than a pipe, then a percentage is displayed along with the --More-- 
prompt. This gives the fraction of the file (in characters, not lines) that has been read so far. 


Other sequences which may be typed when more pauses, and their effects, are as follows (i is an optional 
integer argument, defaulting to 1): 


i<space> 
display i more lines, (or another screenful if no argument is given) 
“D display 11 more lines (a ‘‘scroll’’). If iis given, then the scroll size is set toi. 
d same as “D (control-D) 
iz same as typing a space except that i, if present, becomes the new window size. 
is skip i lines and print a screenful of lines 
if skip i screenfuls and print a screenful of lines 
ib skip back i screenfuls and print a screenful of lines 
i“B same as b 


qorQ_ Exit from more. 

= Display the current line number. 

v Start up the editor vi at the current line. 

h Help command; give a description of all the more commands. 


i/expr search for the i-th occurrence of the regular expression expr. If there are less than i occurrences of 
expr, and the input is a file (rather than a pipe), then the position in the file remains unchanged. 
Otherwise, a screenful is displayed, starting two lines before the place where the expression was 
found. The user’s erase and kill characters may be used to edit the regular expression. Erasing 
back past the first column cancels the search command. 


in search for the i-th occurrence of the last regular expression entered. 


(single quote) Go to the point from which the last search started. If no search has been performed 
in the current file, this command goes back to the beginning of the file. 


‘command 
invoke a shell with command . The characters ‘%’ and ‘!’ in "command" are replaced with the cur- 
rent file name and the previous shell command respectively. If there is no current file name, *%’ is 


not expanded. The sequences "\%" and "\!" are replaced by "%" and "!" respectively. 
im skip to the i-th next file given in the command line (skips to last file if n doesn’t make sense) 
i:p skip to the i-th previous file given in the command line. If this command is given in the middle of 


printing out a file, then more goes back to the beginning of the file. If i doesn’t make sense, more 
skips back to the first file. If more is not reading from a file, the bell is rung and nothing else hap- 
pens. 


if display the current file name and line number. 
:q or :Q exit from more (same as q or Q). 
(dot) repeat the previous command. 


The commands take effect immediately, i.e., it is not necessary to type a carriage return. Up to the time 
when the command character itself is given, the user may hit the line kill character to cancel the numerical 
argument being formed. In addition, the user may hit the erase character to redisplay the --More--(xx%) 
message. 
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At any time when output is being sent to the terminal, the user can hit the quit key (normally control-\). 
More will stop sending output, and will display the usual --More-- prompt. The user may then enter one of 
the above commands in the normal manner. Unfortunately, some output is lost when this is done, due to 
the fact that any characters waiting in the terminal’s output queue are flushed when the quit signal occurs. 


The terminal is set to noecho mode by this program so that the output can be continuous. What you type 
will thus not show on your terminal, except for the / and ! commands. 


If the standard output is not a teletype, then more acts just like cat, except that a header is printed before 
each file (if there is more than one). 


A sample usage of more in previewing nroff output would be 


nroff —ms +2 doc.n | more -s 


FILES 
/etc/termcap Terminal data base 
/usr/lib/more.help Help file 

SEE ALSO 


csh(1), man(1), msgs(1), script(1), sh(1), environ(7) 


BUGS 
Skipping backwards is too slow on large files. 
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NAME 


mset — retrieve ASCII to IBM 3270 keyboard map 


SYNOPSIS 


mset 


DESCRIPTION 


FILES 


Mset retrieves mapping information for the ASCII keyboard to IBM 3270 terminal special functions. Nor- 
mally, these mappings are found in /etc/map3270 (see map3270(5)). This information is used by the 
tn3270 command (see tn3270(1)). 


Mset can be used store the mapping information in the process environment in order to avoid scanning 
/etc/map3270 each time tn3270 is invoked. To do this, place the following command in your ./ogin file: 


set noglob; setenv MAP3270 "*mset’"; unset noglob 


Mset first determines the user’s terminal type from the environment variable TERM. Normally mset then 
uses the file /etc/map3270 to find the keyboard mapping for that terminal. However, if the environment 
variable MAP3270 exists and contains the entry for the specified terminal, then that definition is used. If 
the value of MAP3270 begins with a slash (‘/’) then it is assumed to be the full pathname of an alternate 
mapping file and that file is searched first. In any case, if the mapping for the terminal is not found in the 
environment, nor in an alternate map file, nor in the standard map file, then the same search is performed 
for an entry for a terminal type of unknown. If that search also fails, then a default mapping is used. 


/etc/map3270 keyboard mapping for known terminals 


SEE ALSO 


BUGS 


tn3270(1), map3270(5) 


If the entry for the specific terminal exceeds 1024 bytes, csh(1) will fail to set the environment variable. 
Mset should probably detect this case and output the path to the map3270 file instead of the terminal entry. 
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NAME 


msgs — system messages and junk mail program 


SYNOPSIS 


msgs [ -fhlpq | [ number ] [ —number ] 
msgs —-s 


msgs —c [ —-days ] 


DESCRIPTION 


Msgs is used to read system messages. These messages are sent by mailing to the login ‘msgs’ and should 
be short pieces of information which are suitable to be read once by most users of the system. 


Msgs is normally invoked each time you login, by placing it in the file .login (.profile if you use /bin/sh). It 
will then prompt you with the source and subject of each new message. If there is no subject line, the first 
few non-blank lines of the message will be displayed. If there is more to the message, you will be told how 
long it is and asked whether you wish to see the rest of the message. The possible responses are: 


y type the rest of the message. 


RETURN 
synonym for y. 


n skip this message and go on to the next message. 
- redisplay the last message. 
q drops you out of msgs; the next time you run the program it will pick up where you left off. 


s append the current message to the file ‘‘Messages’’ in the current directory; “s—’ will save the pre- 
viously displayed message. A ‘s’ or ‘s—’ may be followed by a space and a file name to receive the 
message replacing the default ‘‘Messages’’. 


m or ‘m—’ causes a copy of the specified message to be placed in a temporary mailbox and mail(1) to 
be invoked on that mailbox. Both ‘m’ and ‘s’ accept a numeric argument in place of the “—’. 


Msgs keeps track of the next message you will see by a number in the file .msgsrc in your home directory. 
In the directory /usr/msgs it keeps a set of files whose names are the (sequential) numbers of the messages 
they represent. The file /zs7/msgs/bounds shows the low and high number of the messages in the directory 
so that msgs can quickly determine if there are no messages for you. If the contents of bounds is incorrect it 
can be fixed by removing it; msgs will make a new bounds file the next time it is run. 


The —s option is used for setting up the posting of messages. The line 
msgs: "| /usr/ucb/msgs —s" 
should be include in /usr/lib/aliases to enable posting of messages. 


The —c option is used for performing cleanup on /usr/msgs. An entry with the —c option should be placed in 
/usrib/crontab to run every night. This will remove all messages over 21 days old. A different expiration 
may be specified on the command line to override the default. 


Options when reading messages include: 


-f which causes it not to say ‘‘No new messages.’’. This is useful in your .Jogin file since this is 
often the case here. 


-q Queries whether there are messages, printing “‘There are new messages.’’ if there are. The com- 
mand ‘‘msgs —q’’ is often used in login scripts. 


-h causes msgs to print the first part of messages only. 


-l option causes only locally originated messages to be reported. 
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num A message number can be given on the command line, causing msgs to start at the specified mes- 
sage rather than at the next message indicated by your .msgsrc file. Thus 


msgs —h | 
prints the first part of all messages. 


—number 
will cause msgs to start number messages back from the one indicated by your .msgsrc file, useful 
for reviews of recent messages. 


-p causes long messages to be piped through more (1). 


Within msgs you can also go to any specific message by typing its number when msgs requests input as to 


what to do. 
FILES 
/usr/msgs/* database 
~/.msgsrc number of next message to be presented 
AUTHORS 
William Joy 
David Wasley 
SEE ALSO 
aliases(5), crontab(5), mail(1), more(1) 
BUGS 
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NAME 
mt — magnetic tape manipulating program 


SYNOPSIS 
mt [ -f tapename | command [ count | 


DESCRIPTION 
Mt is used to give commands to a magnetic tape drive. If a tape name is not specified, the environment 
variable TAPE is used; if TAPE does not exist, mt uses the device /dev/rmt12. Note that tapename must 
reference a raw (not block) tape device. By default mt performs the requested operation once. Operations 
may be performed multiple times by specifying count. 


The available commands are listed below. Only as many characters as are required to uniquely identify a 
command need be specified. 


eof, weof 
Write count end-of-file marks at the current position on the tape. 


fsf Forward space count files. 
fsr Forward space count records. 
bsf Back space count files. 

bsr Back space count records. 


rewind Rewind the tape (Count is ignored). 


offline, rewoffl 
Rewind the tape and place the tape unit off-line (Count is ignored). 


status Print status information about the tape unit. 


Mt returns a 0 exit status when the operation(s) were successful, 1 if the command was unrecognized, and 2 
if an operation failed. 


FILES 
/dev/rmt* Raw magnetic tape interface 


SEE ALSO 
mtio(4), dd(1), ioctl(2), environ(7) 
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NAME 
mv — move or rename files 


SYNOPSIS 
my [-i][-f][-] filel file2 


mv [-i][-f][-] file ... directory 


DESCRIPTION 
Mv moves (changes the name of) file/ to file2. 


If file2 already exists, it is removed before file] is moved. If file2 has a mode which forbids writing, mv 
prints the mode (see chmod(2)) and reads the standard input to obtain a line; if the line begins with y, the 
move takes place; if not, mv exits. 


In the second form, one or more files (plain files or directories) are moved to the directory with their origi- 
nal file-names. 


Mv refuses to move a file onto itself. 


Options: 

-i stands for interactive mode. Whenever a move is to supercede an existing file, the user is prompted 
by the name of the file followed by a question mark. If he answers with a line starting with ’y’, the 
move continues. Any other reply prevents the move from occurring. 

-f stands for force. This option overrides any mode restrictions or the —1 switch. 

- means interpret all the following arguments to mv as file names. This allows file names starting 
with minus. 

SEE ALSO 


cp(1), In(1) 


BUGS 
If filel and file2 lie on different file systems, mv must copy the file and delete the original. In this case the 
owner name becomes that of the copying process and any linking relationship with other files is lost. 
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NAME 
netstat — show network status 


SYNOPSIS 
netstat [ —-Aan ] [ -f address_family | [ system | [ core ] 
netstat [ -himnrs ] [ -f address_family | [ system ] [ core ] 
netstat [ —n | [ -I interface | interval [ system | [ core | 


DESCRIPTION 
The netstat command symbolically displays the contents of various network-related data structures. There 
are a number of output formats, depending on the options for the information presented. The first form of 
the command displays a list of active sockets for each protocol. The second form presents the contents of 
one of the other network data structures according to the option selected. Using the third form, with an 
interval specified, netstat will continuously display the information regarding packet traffic on the 
configured network interfaces. 


The options have the following meaning: 


-A With the default display, show the address of any protocol control blocks associated with sockets; 
used for debugging. 
-a With the default display, show the state of all sockets; normally sockets used by server processes 


are not shown. 
-h Show the state of the IMP host table. 


-i Show the state of interfaces which have been auto-configured (interfaces statically configured into 
a system, but not located at boot time are not shown). 


-I interface 
Show information only about this interface; used with an interval as described below. 


—m Show statistics recorded by the memory management routines (the network manages a private 
pool of memory buffers). 


—n Show network addresses as numbers (normally netstat interprets addresses and attempts to display 
them symbolically). This option may be used with any of the display formats. 


-s Show per-protocol statistics. 
-r Show the routing tables. When —s is also present, show routing statistics instead. 
-f address_family 


Limit statistics or address control block reports to those of the specified address family. The fol- 
lowing address families are recognized: inet, for AF INET, ns, for AF_NS, and unix, for 
AF UNIX. 


The arguments, system and core allow substitutes for the defaults ‘‘/vmunix’’ and ‘‘/dev/kmem’’. 


The default display, for active sockets, shows the local and remote addresses, send and receive queue sizes 
(in bytes), protocol, and the internal state of the protocol. Address formats are of the form ‘‘host.port’’ or 
“network.port’’ if a socket’s address specifies a network but no specific host address. When known the 
host and network addresses are displayed symbolically according to the data bases /etc/hosts and 
/etc/networks , respectively. If a symbolic name for an address is unknown, or if the —n option is specified, 
the address is printed numerically, according to the address family. For more information regarding the 
Internet ‘‘dot format,’’ refer to inet(3N). Unspecified, or ‘‘wildcard’’, addresses and ports appear as ‘‘*’’. 


The interface display provides a table of cumulative statistics regarding packets transferred, errors, and col- 
lisions. The network addresses of the interface and the maximum transmission unit (‘‘mtu’’) are also dis- 
played. 
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The routing table display indicates the available routes and their status. Each route consists of a destination 
host or network and a gateway to use in forwarding packets. The flags field shows the state of the route 
(‘‘U”’ if “‘up’’), whether the route is to a gateway (‘‘G’’), and whether the route was created dynamically 
by a redirect (‘‘D’’). Direct routes are created for each interface attached to the local host; the gateway field 
for such entries shows the address of the outgoing interface. The refcnt field gives the current number of 
active uses of the route. Connection oriented protocols normally hold on to a single route for the duration 
of a connection while connectionless protocols obtain a route while sending to the same destination. The 
use field provides a count of the number of packets sent using that route. The interface entry indicates the 
network interface utilized for the route. 


When netstat is invoked with an interval argument, it displays a running count of statistics related to net- 
work interfaces. This display consists of a column for the primary interface (the first interface found during 
autoconfiguration) and a column summarizing information for all interfaces. The primary interface may be 
replaced with another interface with the —J option. The first line of each screen of information contains a 
summary since the system was last rebooted. Subsequent lines of output show values accumulated over the 
preceding interval. 


SEE ALSO 


BUGS 


iostat(1), vmstat(1), hosts(5), networks(5), protocols(5), services(5), trpt(8C) 


The notion of errors is ill-defined. Collisions mean something else for the IMP. 
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NAME 
newaliases — rebuild the data base for the mail aliases file 


SYNOPSIS 
newaliases 


DESCRIPTION 
Newaliases rebuilds the random access data base for the mail aliases file /usr/lib/aliases. It must be run 
each time /usr/lib/aliases is changed in order for the change to take effect. 


SEE ALSO 
aliases(5), sendmail(8) 
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NAME 
nice, nohup — run a command at low priority (sh only) 


SYNOPSIS 
nice [ —number | command [ arguments ] 


nohup command [ arguments ] 


DESCRIPTION 
Nice executes command with low scheduling priority. If the number argument is present, the priority is 


incremented (higher numbers mean lower priorities) by that amount up to a limit of 20. The default number 
is 10. 


The super-user may run commands with priority higher than normal by using a negative priority, e.g. 
‘“—10’. 


Nohup executes command immune to hangup and terminate signals from the controlling terminal. The pri- 
ority is incremented by 5. Nohup should be invoked from the shell with ‘&’ in order to prevent it from 
responding to interrupts by or stealing the input from the next person who logs in on the same terminal. 


FILES 

nohup.out standard output and standard error file under nohup 
SEE ALSO 

csh(1), setpriority(2), renice(8) 
DIAGNOSTICS 


Nice returns the exit status of the subject command. 


BUGS 
Nice and nohup are particular to sh(1). If you use csh(1), then commands executed with ‘‘&’’ are automat- 
ically immune to hangup signals while in the background. There is a builtin command nohup which pro- 
vides immunity from terminate, but it does not redirect output to nohup.out. 


Nice is built into csh(1) with a slightly different syntax than described here. The form “‘nice +10’’ nices to 
positive nice, and “‘nice —10’’ can be used by the super-user to give a process more of the processor. 
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NAME 
nm — print name list 


SYNOPSIS 
nm [ —agnopru | [ file ... ] 


DESCRIPTION 
Nm prints the name list (symbol table) of each object file in the argument list. If an argument is an archive, 
a listing for each object file in the archive will be produced. If no file is given, the symbols in "a.out" are 
listed. 


Each symbol name is preceded by its value (blanks if undefined) and one of the letters U (undefined), A 
(absolute), T (text segment symbol), D (data segment symbol), B (bss segment symbol), C (common sym- 
bol), f file name, or — for debugger symbol table entries (see —a below). If the symbol is local (non- 
external) the type letter is in lower case. The output is sorted alphabetically. 


Options are: 
-a Print symbol table entries inserted for use by debuggers. 


-g Print only global (external) symbols. 


—n Sort numerically rather than alphabetically. 
-0 Prepend file or archive element name to each output line rather than only once. 
-p Don’t sort; print in symbol-table order. 
-r Sort in reverse order. 
-u Print only undefined symbols. 
SEE ALSO 


ar(1), ar(5), a.out(5), stab(5) 
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NAME 


nroff — text formatting 


SYNOPSIS 


nroff [ option ] ... [ file ] ... 


DESCRIPTION 


Nroff formats text in the named files for typewriter-like devices. See also troff(1). The full capabilities of 
nroff are described in the Nroff/Troff User’s Manual. 


If no file argument is present, the standard input is read. An argument consisting of a single minus (—) is 
taken to be a file name corresponding to the standard input. 


The options, which may appear in any order so long as they appear before the files, are: 


-olist Print only pages whose page numbers appear in the comma-separated /ist of numbers and ranges. 
A range N—M means pages N through M; an initial -N means from the beginning to page N; and a 
final N— means from N to the end. 


—nN Number first generated page N. 


-sN Stop every N pages. Nroff will halt prior to every N pages (default N=1) to allow paper loading or 
changing, and will resume upon receipt of a newline. 


—mname 
Prepend the macro file /usr/lib/tmac/tmac.name to the input files. 


-raN _ Set register a (one-character) to N. 
-i Read standard input after the input files are exhausted. 
-q Invoke the simultaneous input-output mode of the rd request. 


-Tname Prepare output for specified terminal. Known names are 37 for the (default) Teletype Corporation 
Model 37 terminal, tn300 for the GE TermiNet 300 (or any terminal without half-line capability), 
3008S for the DASI-300S, 300 for the DASI-300, and 450 for the DASI-450 (Diablo Hyterm). 


-e Produce equally-spaced words in adjusted lines, using full terminal resolution. 


-h Use output tabs during horizontal spacing to speed output and reduce output character count. Tab 
settings are assumed to be every 8 nominal character widths. 


FILES 
/tmp/ta* temporary file 
/usr/lib/tmac/tmac.* standard macro files 
/usr/lib/term/* terminal driving tables for nroff 
SEE ALSO 


J. F. Ossanna, Nroff/Troff user’s manual 
B. W. Kernighan, A TROFF Tutorial 
troff(1), eqn(1), tbl(1), ms(7), me(7), man(7), col(1) 
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NAME 


UNIX Programmer’s Manual OD(1) 


od — octal, decimal, hex, ascii dump 


SYNOPSIS 


od [ -format ] [ file ] [ [+]offset[.][b] [label] ] 


DESCRIPTION 


Od displays file, or it’s standard input, in one or more dump formats as selected by the first argument. If 
the first argument is missing, —o is the default. Dumping continues until end-of-file. 


The meanings of the format argument characters are: 


a Interpret bytes as characters and display them with their ACSII names. If the p character is given 
also, then bytes with even parity are underlined. The P character causes bytes with odd parity to be 
underlined. Otherwise the parity bit is ignored. 


b Interpret bytes as unsigned octal. 


c Interpret bytes as ASCII characters. Certain non-graphic characters appear as C escapes: null=\0, 
backspace=\b, formfeed=\f, newline=\n, return=\r, tab=\t; others appear as 3-digit octal numbers. 
Bytes with the parity bit set are displayed in octal. 


d Interpret (short) words as unsigned decimal. 
f Interpret long words as floating point. 
h 


Interpret (short) words as unsigned hexadecimal. 


i Interpret (short) words as signed decimal. 
] Interpret long words as signed decimal. 
(1) Interpret (short) words as unsigned octal. 


s[n] Look for strings of ascii graphic characters, terminated with a null byte. N specifies the minimum 
length string to be recognized. By default, the minimum length is 3 characters. 


v Show all data. By default, display lines that are identical to the last line shown are not output, but are 
indicated with an ‘**’’ in column 1. 


w([n] Specifies the number of input bytes to be interpreted and displayed on each output line. If w is not 
specified, 16 bytes are read for each display line. If n is not specified, it defaults to 32. 


x Interpret (short) words as hexadecimal. 
An upper case format character implies the long or double precision form of the object. 


The offset argument specifies the byte offset into the file where dumping is to commence. By default this 
argument is interpreted in octal. A different radix can be specified; If ‘‘.’’ is appended to the argument, 
then offset is interpreted in decimal. If offset begins with ‘‘x’’ or ‘‘Ox’’, it is interpreted in hexadecimal. If 
“‘b’’ (‘‘B’’) is appended, the offset is interpreted as a block count, where a block is 512 (1024) bytes. If the 


file argument is omitted, an offset argument must be preceded by ‘‘+’’. 


The radix of the displayed address will be the same as the radix of the offset, if specified; otherwise it will 
be octal. 


Label will be interpreted as a pseudo-address for the first byte displayed. It will be shown in ‘‘()’’ follow- 
ing the file offset. It is intended to be used with core images to indicate the real memory address. The syn- 
tax for label is identical to that for offset. 


SEE ALSO 


BUGS 


adb(1) 


A file name argument can’t start with ‘‘+’’. A hexadecimal offset can’t be a block count. Only one file 
name argument can be given. 
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It is an historical botch to require specification of object, radix, and sign representation in a single character 
argument. 
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NAME 

pagesize — print system page size 
SYNOPSIS 

pagesize 


DESCRIPTION 
Pagesize prints the size of a page of memory in bytes, as returned by getpagesize(2). This program is use- 
ful in constructing portable shell scripts. 


SEE ALSO 
getpagesize(2) 
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NAME 


chfn, chsh, passwd — change password file information 


SYNOPSIS 


passwd [ -f ] [-s ] [ name ] 


DESCRIPTION 


This command changes (or installs) a password, login shell (-s option), or GECOS information field (-f 
option) associated with the user name (your own name by default). 


When altering a password, the program prompts for the current password and then for the new one. The 
caller must supply both. The new password must be typed twice to forestall mistakes. 


New passwords must be at least four characters long if they use a sufficiently rich alphabet and at least six 
characters long if monocase. These rules are relaxed if you are insistent enough. 


Only the owner of the name or the super-user may change a password; the owner must prove he knows the 
old password. 


When altering a login shell, passwd displays the current login shell and then prompts for the new one. The 
new login shell must be one of the approved shells listed in /etc/shells unless you are the super-user. If 
/etc/shells does not exist, the only shells that may be specified are /bin/sh and /bin/csh. 


The super-user may change anyone’s login shell; normal users may only change their own login shell. 


When altering the GECOS information field, passwd displays the current information, broken into fields, as 
interpreted by the finger(1) program, among others, and prompts for new values. These fields include a 
user’s ‘‘real life’? name, office room number, office phone number, and home phone number. Included in 
each prompt is a default value, which is enclosed between brackets. The default value is accepted simply 
by typing a carriage return. To enter a blank field, the word ‘‘none’’ may be typed. Below is a sample run: 


Name [Biff Studsworth IT]: 

Room number (Exs: 597E or 197C) []: 521E 
Office Phone (Ex: 1632) []: 1863 

Home Phone (Ex: 987532) [5771546]: none 


Passwd allows phone numbers to be entered with or without hyphens. It is a good idea to run finger after 
changing the GECOS information to make sure everything is setup properly. 


The super-user may change anyone’s GECOS information; normal users may only change their own. 


FILES 
/etc/passwd The file containing all of this information 
/etc/shells The list of approved shells 

SEE ALSO 


login(1), finger(1), passwd(5), crypt(3) 
Robert Morris and Ken Thompson, UNIX password security 
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NAME 
pe — Pascal compiler 


SYNOPSIS 
pe [ option ] [-iname... ] name ... 


DESCRIPTION 
Pc is a Pascal compiler. If given an argument file ending with .p, it will compile the file and load it into an 
executable file called, by default, a.out. 


A program may be separated into more than one .p file. Pc will compile a number of argument .p files into 
object files (with the extension .o in place of .p). Object files may then be loaded into an executable a.out 
file. Exactly one object file must supply a program statement to successfully create an executable a.out 
file. The rest of the files must consist only of declarations which logically nest within the program. Refer- 
ences to objects shared between separately compiled files are allowed if the objects are declared in included 
header files, whose names must end with .h. Header files may only be included at the outermost level, and 
thus declare only globally available objects. To allow functions and procedures to be declared, an exter- 
nal directive has been added, whose use is similar to the forward directive but restricted to appear only in 
-h files. Function and procedure bodies may not appear in -h files. A binding phase of the compiler 
checks that declarations are used consistently, to enforce the type checking rules of Pascal. 


Object files created by other language processors may be loaded together with object files created by pc. 
The functions and procedures they define must have been declared in .h files included by all the .p files 
which call those routines. Calling conventions are as in C, with var parameters passed by address. 


See the Berkeley Pascal User’s Manual for details. 

The following options have the same meaning as in cc(1) and f77(1). See /d(1) for load-time options. 
+ Suppress loading and produce *.o’ file(s) from source file(s). 

-g Have the compiler produce additional symbol table information for dbx(1). 

-w Suppress warning messages. 

-p Prepare object files for profiling, see prof(1). 

-O Invoke an object-code improver. 


-S Compile the named program, and leave the assembler-language output on the corresponding file 
suffixed ‘.s’. (No ‘.o’ is created.). 


—0 output 
Name the final output file output instead of a.out. 


The following options are peculiar to pc. 

-C Compile code to perform runtime checks, verify assert calls, and initialize all variables to zero as in 
pi. 

-b Block buffer the file output. 


-i Produce a listing for the specified procedures, functions and include files. 
-l Make a program listing during translation. 
-s Accept standard Pascal only; non-standard constructs cause warning diagnostics. 


-t directory 
Use the given directory for compiler temporary files. 


-Z Allow execution profiling with pxp by generating statement counters, and arranging for the creation 
of the profile data file pmon.out when the resulting object is executed. 
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Other arguments are taken to be loader option arguments, perhaps libraries of pc compatible routines. Cer- 
tain flags can also be controlled in comments within the program as described in the Berkeley Pascal User’s 
Manual. 


FILES 
file.p pascal source files 
/usr/lib/pcO compiler 
/Nib/f1 code generator 
/usr/lib/pc2 runtime integrator (inline expander) 
Nib/c2 peephole optimizer 
/usr/lib/pc3 separate compilation consistency checker 
/usr/lib/pc2.*strings text of the error messages 
/usr/lib/how_ pce basic usage explanation 
/usr/lib/libpe.a intrinsic functions and I/O library 
/usr/lib/libm.a math library 
/lib/libe.a standard library, see intro(3) 

SEE ALSO 


Berkeley Pascal User’s Manual 
pi(1), pxp(1), pxref(1), sdb(1) 


DIAGNOSTICS 


For a basic explanation do 


pe 
See pi(1). for an explanation of the error message format. Internal errors cause messages containing the 
word SNARK. 


AUTHORS 


BUGS 


Charles B. Haley, William N. Joy, and Ken Thompson 

Retargetted to the second pass of the portable C compiler by Peter Kessler 
Runtime library and inline optimizer by M. Kirk McKusick 

Separate compilation consistency checking by Louise Madrid 


The keyword packed is recognized but has no effect. 


The binder is not as strict as described here, with regard to the rules about external declarations only in ‘.h’ 
files and including ‘.h’ files only at the outermost level. It will be made to perform these checks in its next 
incarnation, so users are warned not to be sloppy. 


The —z flag doesn’t work for separately compiled files. 


Because the -s option is usurped by the compiler, it is not possible to pass the strip option to the loader. 
Thus programs which are to be stripped, must be run through strip(1) after they are compiled. 
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NAME 
pdx — pascal debugger 


SYNOPSIS 
pdx [-r] [objfile] 


DESCRIPTION 
Pdx is a tool for source level debugging and execution of Pascal programs. The objfile is an object file pro- 
duced by the Pascal translator pi(1). If no objfile is specified, pdx looks for a file named ‘‘obj’’ in the cur- 
rent directory. The object file contains a symbol table which includes the name of the all the source files 
translated by pi to create it. These files are available for perusal while using the debugger. 


If the file ‘‘ pdxinit’’ exists in the current directory, then the debugger commands in it are executed. 


The -r option causes the objfile to be executed immediately; if it terminates successfully pdx exits. Other- 
wise it reports the reason for termination and offers the user the option of entering the debugger or simply 
letting px continue with a traceback. If -r is not specified, pdx just prompts and waits for a command. 


The commands are: 


run [args] [< filename] [> filename] 
Start executing objfile, passing args as command line arguments; < or > can be used to redirect 
input or output in the usual manner. 


trace [in procedure/function] [if condition] 

trace source-line-number [if condition] 

trace procedure/function [in procedure/function] [if condition] 

trace expression at source-line-number [if condition] 

trace variable [in procedure/function] [if condition] 
Have tracing information printed when the program is executed. A number is associated with the 
command that is used to turn the tracing off (see the delete command). 


The first argument describes what is to be traced. If it is a source-line-number, then the line is 
printed immediately prior to being executed. Source line numbers in a file other than the current 
one must be preceded by the name of the file and a colon, e.g. “‘mumble.p:17’’. 


If the argument is a procedure or function name then every time it is called, information is printed 
telling what routine called it, from what source line it was called, and what parameters were passed 
to it. In addition, its return is noted, and if it’s a function then the value it is returning is also 


printed. 


If the argument is an expression with an at clause then the value of the expression is printed when- 
ever the identified source line is reached. 


If the argument is a variable then the name and value of the variable is printed whenever it 
changes. Execution is substantially slower during this form of tracing. 


If no argument is specified then all source lines are printed before they are executed. Execution is 
substantially slower during this form of tracing. 


The clause ‘‘in procedure/function’’ restricts tracing information to be printed only while execut- 
ing inside the given procedure or function. 


Condition is a Pascal boolean expression and is evaluated prior to printing the tracing information; 
if it is false then the information is not printed. 


There is no restriction on the amount of information that can be traced. 
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stop if condition 

stop at source-line-number [if condition] 

stop in procedure/function [if condition] 

stop variable [if condition] 
Stop execution when the given line is reached, procedure or function called, variable changed, or 
condition true. 


delete command-number 
The trace or stop corresponding to the given number is removed. The numbers associated with 
traces and stops are printed by the status command. 


status [> filename] 
Print out the currently active trace and stop commands. 


cont Continue execution from where it stopped. This can only be done when the program was stopped 
by an interrupt or through use of the stop command. 


step Execute one source line. 


next Execute up to the next source line. The difference between this and step is that if the line contains 
a call to a procedure or function the step command will stop at the beginning of that block, while 
the next command will not. 


print expression [, expression ...] 
Print out the values of the Pascal expressions. Variables declared in an outer block but having the 
same identifier as one in the current block may be referenced as ‘‘block-name . variable’’. 


whatis identifier 
Print the declaration of the given identifier. 


which identifier 
Print the full qualification of the given identifer, i.e. the outer blocks that the identifier is associ- 
ated with. 


assign variable expression 
Assign the value of the expression to the variable. 


call procedure(parameters) 
Execute the object code associated with the named procedure or function. 


help Print out a synopsis of pdx commands. 
gripe Invokes a mail program to send a message to the person in charge of pdx. 


where Print out a list of the active procedures and functions and the respective source line where they are 
called. 


source filename 
Read pdx commands from the given filename. Especially useful when the filename has been cre- 
ated by redirecting a status command from an earlier debugging session. 


dump [> filename] 
Print the names and values of all active data. 


list [source-line-number [, source-line-number]| 

list procedure/function 
List the lines in the current source file from the first line number to the second inclusive. As in the 
editor ‘‘$’’ can be used to refer to the last line. If no lines are specified, the entire file is listed. If 
the name of a procedure or function is given lines n-k to n+k are listed where n is the first state- 
ment in the procedure or function and k is small. 


file [filename] 
Change the current source file name to filename. If none is specified then the current source file 
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name is printed. 


edit [filename] 

edit procedure/function-name 
Invoke an editor on filename or the current source file if none is specified. If a procedure or func- 
tion name is specified, the editor is invoked on the file that contains it. Which editor is invoked by 
default depends on the installation. The default can be overridden by setting the environment vari- 
able EDITOR to the name of the desired editor. 


pi Recompile the program and read in the new symbol table information. 


sh command-line 
Pass the command line to the shell for execution. The SHELL environment variable determines 
which shell is used. 


alias new-command-name old-command-name 
This command makes pdx respond to new-command-name the way it used to respond to old- 
commanad-name. 


quit Exit pdx. 


The following commands deal with the program at the px instruction level rather than source level. They 
are not intended for general use. 


tracei [address] [if cond] 
tracei [variable] [at address] [if cond] 
stopi [address] [if cond] 
stopi [at] [address] [if cond] 
Turn on tracing or set a stop using a px machine instruction addresses. 


xi address [, address| 
Print the instructions starting at the first address. Instructions up to the second address are printed. 


xd address [, address] 
Print in octal the specified data location(s). 


FILES 
obj Pascal object file 
._pdxinit Pax initialization file 
SEE ALSO 


BUGS 


pi(1), px(1) 
An Introduction to Pdx 


Pdx does not understand sets, and provides no information about files. 

The whatis command doesn’t quite work for variant records. 

Bad things will happen if a procedure invoked with the call command does a non-local goto. 

The commands step and next should be able to take a count that specifies how many lines to execute. 


There should be commands stepi and nexti that correspond to step and next but work at the instruction 
level. 
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There should be a way to get an address associated with a line number, procedure or function, and variable. 
Most of the command names are too long. 
The alias facility is quite weak. 


A csh-like history capability would improve the situation. 
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NAME 
pi — Pascal interpreter code translator 
SYNOPSIS 
pi [ option ] [-i name ... ] name.p 
DESCRIPTION 
Pi translates the program in the file name.p leaving interpreter code in the file obj in the current directory. 
The interpreter code can be executed using px. Pix performs the functions of pi and px for ‘load and go’ 
Pascal. 
The following flags are interpreted by pi; the associated options can also be controlled in comments within 
the program as described in the Berkeley Pascal User’s Manual. 
—-b Block buffer the file output. 
-i Enable the listing for any specified procedures and functions and while processing any specified 
include files. 
-l Make a program listing during translation. 
—n Begin each listed include file on a new page with a banner line. 
-p Suppress the post-mortem control flow backtrace if an error occurs; suppress statement limit count- 
ing. 
-s Accept standard Pascal only; non-standard constructs cause warning diagnostics. 
-t Suppress runtime tests of subrange variables and treat assert statements as comments. 
-u Card image mode; only the first 72 characters of input lines are used. 
-w Suppress warning diagnostics. 
-Z Allow execution profiling with pxp by generating statement counters, and arranging for the creation 
of the profile data file pmon.out when the resulting object is executed. 
FILES 
file.p input file 
file.i include file(s) 
/usr/lib/pi2.*strings text of the error messages 
/usr/lib/how_pi* basic usage explanation 
obj interpreter code output 
SEE ALSO 


Berkeley Pascal User’s Manual 

pix(1), px(1), pxp(1), pxref(1) 
DIAGNOSTICS 

For a basic explanation do 


pi 
In the diagnostic output of the translator, lines containing syntax errors are listed with a flag indicating the 
point of error. Diagnostic messages indicate the action which the recovery mechanism took in order to be 


able to continue parsing. Some diagnostics indicate only that the input is ‘malformed.’ This occurs if the 
recovery can find no simple correction to make the input syntactically valid. 


Semantic error diagnostics indicate a line in the source text near the point of error. Some errors evoke more 
than one diagnostic to help pinpoint the error; the follow-up messages begin with an ellipsis *...’. 
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The first character of each error message indicates its class: 


E Fatal error; no code will be generated. 

e Non-fatal error. 

w Warning — a potential problem. 

S Non-standard Pascal construct warning. 


If a severe error occurs which inhibits further processing, the translator will give a diagnostic and then 
‘QUIT’. 
AUTHORS 
Charles B. Haley, William N. Joy, and Ken Thompson 
Ported to VAX-11 by Peter Kessler 


BUGS 
The keyword packed is recognized but has no effect. 


For clarity, semantic errors should be flagged at an appropriate place in the source text, and multiple 
instances of the ‘same’ semantic error should be summarized at the end of a procedure or function rather 
than evoking many diagnostics. 


When include files are present, diagnostics relating to the last procedure in one file may appear after the 
beginning of the listing of the next. 
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NAME 

pix — Pascal interpreter and executor 
SYNOPSIS 

pix [ -bInpstuwz ] [-i name... ] name.p [ argument ... ] 
DESCRIPTION 


Pix is a ‘load and go’ version of Pascal which combines the functions of the interpreter code translator pi 
and the executor px. It uses pi to translate the program in the file name.p and, if there were no fatal errors 
during translation, causes the resulting interpreter code to be executed by px with the specified arguments. 
A temporary file is used for the object code; the file obj is neither created nor destroyed. 


FILES 
/usr/ucb/pi Pascal translator 
/ust/ucb/px Pascal executor 
/tmp/pix* temporary 
/usr/lib/how_pix basic explanation 
SEE ALSO 


Berkeley Pascal User’s Manual 
pi(1), px(1) 


DIAGNOSTICS 
For a basic explanation do 


pix 
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NAME 


plot — graphics filters 


SYNOPSIS 


plot [ -Tterminal ] [ -rresolution ] [ files... ] 


DESCRIPTION 


FILES 


These commands read plotting instructions (see plot(5)) from the standard input or the specified files, and 
in general produce plotting instructions suitable for a particular terminal on the standard output. The —-r 
flag may be used to specify the device’s output resolution (currently only the Imagen laser printer under- 
stands this option). 


If no terminal type is specified, the environment parameter $TERM (see environ(7)) is used. Known termi- 
nals are: 


4013 Tektronix 4013 storage scope. 


4014 or tek 
Tektronix 4014 or 4015 storage scope with Enhanced Graphics Module. (Use 4013 for Tektronix 
4014 or 4015 without the Enhanced Graphics Module). 


450 DASI Hyterm 450 terminal (Diablo mechanism). 
300 DASI 300 or GSI terminal (Diablo mechanism). 
300S = DASI 3008S terminal (Diablo mechanism). 

aed AED 512 color graphics terminal. 


bitgraph or bg 
BBN bitgraph graphics terminal. 


imagen or ip 
Imagen laser printer (default 240 dots-per-inch resolution). 


crt Any crt terminal capable of running vi(1). 
dumb Dumb terminals without cursor addressing or line printers. 
vt125. = DEC vt125 terminal. 


hp2648 or hp or hp8 
Hewlett Packard 2648 graphics terminal. 


ver Versatec D1200A printer-plotter. 
var Benson Varian printer-plotter. 


These versions of plot use the -g option of /pr(1) to send the result directly to the plotter device 
rather than to the standard output. 


/usr/bin/t4013 
/usr/bin/tek 
/usr/bin/t450 
/usr/bin/t300 
/usr/bin/t300s 
/usr/bin/aedplot 
/usr/bin/bgplot 
/usr/bin/crtplot 
/usr/bin/dumbplot 
/usr/bin/gigiplot 
/usr/bin/hpplot 
/usr/bin/implot 
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/asr/ucb/lpr 


SEE ALSO 
plot(3X), plot@F), plot(5), Ipr(1) 
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NAME 

pmerge — pascal file merger 
SYNOPSIS 

pmerge name.p ... 
DESCRIPTION 


Pmerge assembles the named Pascal files into a single standard Pascal program. The resulting program is 
listed on the standard output. It is intended to be used to merge a collection of separately compiled mod- 
ules so that they can be run through pi , or exported to other sites. 


FILES 
/asr/tmp/MG* default temporary files 
SEE ALSO 
pe(1), pi(1), 
Auxiliary documentation Berkeley Pascal User’s Manual. 


AUTHOR 
M. Kirk McKusick 


BUGS 
Very minimal error checking is done, so incorrect programs will produce unpredictable results. Block com- 
ments should be placed after the keyword to which they refer or they are likely to end up in bizarre places. 
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NAME 
pr — print file 

SYNOPSIS 
pr [ option]... [ file]... 

DESCRIPTION 
Pr produces a printed listing of one or more files. The output is separated into pages headed by a date, the 
name of the file or a specified header, and the page number. If there are no file arguments, pr prints its stan- 
dard input. 


Options apply to all following files but may be reset between files: 


—n Produce n-column output. 

+n Begin printing with page n. 

-h Take the next argument as a page header. 

-—wn For purposes of multi-column output, take the width of the page to be n characters instead of the 
default 72. 

-f Use formfeeds instead of newlines to separate pages. A formfeed is assumed to use up two blank 


lines at the top of a page. (Thus this option does not affect the effective page length.) 
-In Take the length of the page to be n lines instead of the default 66. 
-t Do not print the 5-line header or the 5-line trailer normally supplied for each page. 


sc Separate columns by the single character c instead of by the appropriate amount of white space. A 
missing c is taken to be a tab. 


—m Print all files simultaneously, each in one column, 
Inter-terminal messages via write (1) are forbidden during a pr. 


FILES 
/dev/tty? to suspend messages. 


SEE ALSO 
cat(1) 


DIAGNOSTICS 
There are no diagnostics when pr is printing on a terminal. 
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NAME 
printenv — print out the environment 


SYNOPSIS 
printenv [ name ] 


DESCRIPTION 
Printenv prints out the values of the variables in the environment. If a name is specified, only its value is 
printed. 


If a name is specified and it is not defined in the environment, printenv returns exit status 1, else it returns 
status 0. 


SEE ALSO 
sh(1), environ(7), csh(1) 
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prof — display profile data 


SYNOPSIS 


prof [-a ][-1][-n] [-z] [-s ] [-v [-low [high ] ] ] [ a.out [ mon.out ... ] ] 


DESCRIPTION 


Prof interprets the file produced by the monitor subroutine. Under default modes, the symbol table in the 
named object file (a.out default) is read and correlated with the profile file (mon.out default). For each 
external symbol, the percentage of time spent executing between that symbol and the next is printed (in 
decreasing order), together with the number of times that routine was called and the number of milliseconds 
per call. If more than one profile file is specified, the output represents the sum of the profiles. 


In order for the number of calls to a routine to be tallied, the -p option of cc, f77 or pc must have been 
given when the file containing the routine was compiled. This option also arranges for the profile file to be 
produced automatically. 


Options are: 

-a all symbols are reported rather than just external symbols. 

-l the output is sorted by symbol value. 

—n the output is sorted by number of calls 

-s a summary profile file is produced in mon.sum. This is really only useful when more than one 
profile file is specified. 

-v all printing is suppressed and a graphic version of the profile is produced on the standard output 
for display by the plot(1) filters. When plotting, the numbers low and high, by default 0 and 100, 
may be given to cause a selected percentage of the profile to be plotted with accordingly higher 
resolution. 

-Z routines which have zero usage (as indicated by call counts and accumulated time) are neverthe- 


FILES 


less printed in the output. 


mon.out for profile 


a.out 


for namelist 


mon.sum for summary profile 


SEE ALSO 


monitor(3), profil(2), cc(1), plot(1G) 


BUGS 


Beware of quantization errors. 


Is confused by f77 which puts the entry points at the bottom of subroutines and functions. 
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ps — process status 


SYNOPSIS 


ps [ acegkInstuvwxU# | 


DESCRIPTION 


Ps prints information about processes. Normally, only your processes are candidates to be printed by ps; 
specifying a causes other users’ processes to be candidates to be printed; specifying x includes processes 
without control terminals in the candidate pool. 


All output formats include, for each process, the process id PID, control terminal of the process TT, cpu 
time used by the process TIME (this includes both user and system time), the state STAT of the process, 
and an indication of the COMMAND which is running. The state is given by a sequence of four letters, 
e.g. ““RWNA’’. The first letter indicates the runnability of the process: R for runnable processes, T for 
stopped processes, P for processes in page wait, D for those in disk (or other short term) waits, S for those 
sleeping for less than about 20 seconds, and I for idle (sleeping longer than about 20 seconds) processes. 
The second letter indicates whether a process is swapped out, showing W if it is, or a blank if it is loaded 
(in-core); a process which has specified a soft limit on memory requirements and which is exceeding that 
limit shows >; such a process is (necessarily) not swapped. The third letter indicates whether a process is 
running with altered CPU scheduling priority (nice); if the process priority is reduced, an N is shown, if the 
process priority has been artificially raised then a ‘<’ is shown; processes running without special treatment 
have just a blank. The final letter indicates any special treatment of the process for virtual memory replace- 
ment; the letters correspond to options to the vadvise(2) call; currently the possibilities are A standing for 
VA_ANOM, S for VA_SEQL and blank for VA_NORM; an A typically represents a lisp(1) in garbage 
collection, S is typical of large image processing programs which are using virtual memory to sequentially 
address voluminous data. 


Here are the options: 


a asks for information about all processes with terminals (ordinarily only one’s own processes are dis- 
played). 
c prints the command name, as stored internally in the system for purposes of accounting, rather than 


the command arguments, which are kept in the process’ address space. This is more reliable, if less 
informative, since the process is free to destroy the latter information. 


e Asks for the environment to be printed as well as the arguments to the command. 


g Asks for all processes. Without this option, ps only prints ‘‘interesting’’ processes. Processes are 
deemed to be uninteresting if they are process group leaders. This normally eliminates top-level 
command interpreters and processes waiting for users to login on free terminals. 


k causes the file /vmcore is used in place of /dev/kmem and /dev/mem. This is used for postmortem sys- 
tem debugging. 

1 asks for a long listing, with fields PPID, CP, PRI, NI, ADDR, SIZE, RSS and WCHAN as described 
below. 


n Asks for numerical output. In a long listing, the WCHAN field is printed numerically rather than 
symbolically, or, in a user listing, the USER field is replaced by a UID field. 


s Adds the size SSIZ of the kernel stack of each process (for use by system maintainers) to the basic 
output format. 


tx restricts output to processes whose controlling tty is x (which should be specified as printed by ps, 
e.g. 3 for tty3, tco for console, tdO for ttydO, t? for processes with no tty, t for processes at the cur- 
rent tty, etc). This option must be the last one given. 


u A user oriented output is produced. This includes fields USER, %CPU, NICE, SIZE, and RSS as 
described below. 
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v A version of the output containing virtual memory statistics is output. This includes fields RE, SL, 
PAGEIN, SIZE, RSS, LIM, TSIZ, TRS, %CPU and %MEM, described below. 


w Use a wide output format (132 columns rather than 80); if repeated, e.g. ww, use arbitrarily wide out- 
put. This information is used to decide how much of long commands to print. 


x asks even about processes with no terminal. 


U causes ps to update a private database where is keeps system information. Thus ‘‘ps U’’ should be 
included in the /etc/re file. 


# A process number may be given, (indicated here by #), in which case the output is restricted to that 
process. This option must also be last. 


A second argument is taken to be the file containing the system’s namelist. Otherwise, /vmunix is used. A 
third argument tells ps where to look for core if the k option is given, instead of /vmcore. If a fourth argu- 
ment is given, it is taken to be the name of a swap file to use instead of the default /dev/drum. 


Fields which are not common to all output formats: 


USER name of the owner of the process 
%CPU cpu utilization of the process; this is a decaying average over up to a minute of previous (real) 
time. Since the time base over which this is computed varies (since processes may be very 
young) it is possible for the sum of all %CPU fields to exceed 100%. 
NICE (or NI) process scheduling increment (see setpriority(2)) 
SIZE virtual size of the process (in 1024 byte units) 
RSS real memory (resident set) size of the process (in 1024 byte units) 
LIM soft limit on memory used, specified via a call to setrlimit(2); if no limit has been specified 
then shown as xx 
TSIZ size of text (shared program) image 
TRS size of resident (real memory) set of text 
%MEM percentage of real memory used by this process. 
RE residency time of the process (seconds in core) 
SL sleep time of the process (seconds blocked) 
PAGEIN number of disk i/o’s resulting from references by the process to pages not loaded in core. 
UID numerical user-id of process owner 
PPID numerical id of parent of process 
CP short-term cpu utilization factor (used in scheduling) 
PRI process priority (non-positive when in non-interruptible wait) 
ADDR swap address of the process 
WCHAN event on which process is waiting (an address in the system). A symbol is chosen that 
classifies the address, unless numerical output is requested (see the n flag). In this case, the ini- 
tial part of the address is trimmed off and is printed hexadecimally, e.g., 0x80004000 prints as 
4000. 
F flags associated with process as in <sys/proc.h>: 
SLOAD 000001 in core 
SSYS 000002 swapper or pager process 
SLOCK 000004 process being swapped out 
SSWAP 000008 _ save area flag 
STRC 000010 process is being traced 


SWTED 000020 another tracing flag 

SULOCK 000040 user settable lock in core 
SPAGE 000080 process in page wait state 
SKEEP 000100 another flag to prevent swap out 
SDLYU 000200 delayed unlock of pages 
SWEXIT 000400 working on exiting 


4th Berkeley Distribution May 12, 1986 2 


PS(1) 


SPHYSIO 
SVFORK 
SVFDONE 
SNOVM 
SPAGI 
SANOM 
SUANOM 
STIMO 
SDETACH 
SOUSIG 


000800 
001000 
002000 
004000 
008000 
010000 
020000 
040000 
080000 
100000 
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doing physical i/o (bio.c) 

process resulted from vfork() 

another vfork flag 

no vm, parent in a vfork() 

init data space on demand from inode 
system detected anomalous vm behavior 
user warned of anomalous vm behavior 
timing out during sleep 

detached inherited by init 

using old signal mechanism 


A process that has exited and has a parent that has not yet waited for the process is marked <defunct>; a 
process which is blocked trying to exit is marked <exiting>; Ps makes an educated guess as to the file name 
and arguments given when the process was created by examining memory or the swap area. The method is 
inherently somewhat unreliable and in any event a process is entitled to destroy this information, so the 
names cannot be counted on too much. 


FILES 
/vmunix system namelist 
/dev/kmem _ kernel memory 
/dev/drum swap device 
/vmcore core file 
/dev searched to find swap device and tty names 


/etc/psdatabase system namelist, device, and wait channel information 


SEE ALSO 
kill(1), w(1) 


BUGS 


Things can change while ps is running; the picture it gives is only a close approximation to reality. 
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NAME 


SYNOPS 
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ptx — permuted index 


1S 
ptx [ option ] ... [input [ output ] ] 


DESCRIPTION 


FILES 


BUGS 


Ptx generates a permuted index to file input on file output (standard input and output default). It has three 
phases: the first does the permutation, generating one line for each keyword in an input line. The keyword 
is rotated to the front. The permuted file is then sorted. Finally, the sorted lines are rotated so the keyword 
comes at the middle of the page. Ptx produces output in the form: 


.xx "tail" "before keyword" "keyword and after" "head" 


where .xx may be an nroff or troff(1) macro for user-defined formatting. The before keyword and keyword 
and after fields incorporate as much of the line as will fit around the keyword when it is printed at the mid- 
dle of the page. Tail and head, at least one of which is an empty string "", are wrapped-around pieces small 
enough to fit in the unused space at the opposite end of the line. When original text must be discarded, ‘/’ 
marks the spot. 


The following options can be applied: 

-f Fold upper and lower case letters for sorting. 

-t Prepare the output for the phototypesetter; the default line length is 100 characters. 

-wn _ Use the next argument, n, as the width of the output line. The default line length is 72 characters. 


-gn Use the next argument, n, as the number of characters to allow for each gap among the four parts 
of the line as finally printed. The default gap is 3 characters. 


-o only Use as keywords only the words given in the only file. 


-i ignore 
Do not use as keywords any words given in the ignore file. If the -i and -o options are missing, 
use /usr/lib/eign as the ignore file. 


—b break 
Use the characters in the break file to separate words. In any case, tab, newline, and space charac- 
ters are always used as break characters. 


-r Take any leading nonblank characters of each input line to be a reference identifier (as to a page or 
chapter) separate from the text of the line. Attach that identifier as a 5th field on each output line. 


The index for this manual was generated using ptx. 


/usr/bin/sort 
/usr/lib/eign 


Line length counts do not account for overstriking or proportional spacing. 
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NAME 
pwd — working directory name 


SYNOPSIS 

pwd 
DESCRIPTION 

Pwd prints the pathname of the working (current) directory. 
SEE ALSO 

cd(1), csh(1), getwd(3) 


BUGS 
In csh(1) the command dirs is always faster (although it can give a different answer in the rare case that the 
current directory or a containing directory was moved after the shell descended into it). 
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NAME 
px — Pascal interpreter 

SYNOPSIS 
px [ obj [ argument ... ] ] 

DESCRIPTION 
Px interprets the abstract machine code generated by pi. The first argument is the file to be interpreted, and 
defaults to obj ; remaining arguments are available to the Pascal program using the built-ins argv and argc. 
Px is also invoked by pix when running ‘load and go’. 
If the program terminates abnormally an error message and a control flow backtrace are printed. The num- 
ber of statements executed and total execution time are printed after normal termination. The p option of pi 
suppresses all of this except the message indicating the cause of abnormal termination. 

FILES 
obj default object file 
pmon.out profile data file 

SEE ALSO 


Berkeley Pascal User’s Manual 
pi(1), pix(1) 
DIAGNOSTICS 
Most run-time error messages are self-explanatory. Some of the more unusual ones are: 


Reference to an inactive file 
A file other than input or output was used before a call to reset or rewrite. 


Statement count limit exceeded 
The limit of 500,000 executed statements (which prevents excessive looping or recursion) has been 
exceeded. 


Bad data found on integer read 

Bad data found on real read 
Usually, non-numeric input was found for a number. For reals, Pascal requires digits before and 
after the decimal point so that numbers like ‘.1’ or ‘21.’ evoke the second diagnostic. 


panic: Some message 
Indicates an internal inconsistency detected in px probably due to a Pascal system bug. 


AUTHORS 
Charles B. Haley, William Joy, and Ken Thompson 
VAX-11 version by Kirk McKusick 


BUGS 
Post-mortem traceback is not limited; infinite recursion leads to almost infinite traceback. 
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NAME 
pxp — Pascal execution profiler 


SYNOPSIS 
pxp [ -acdefjnstuw_ ] [ -23456789 ] [ -z [ name ... ] ] name.p 


DESCRIPTION 
Pxp can be used to obtain execution profiles of Pascal programs or as a pretty-printer. To produce an exe- 
cution profile all that is necessary is to translate the program specifying the z option to pi or pix, to execute 
the program, and to then issue the command 


Pxp -z name.p 

A reformatted listing is output if none of the c, t, or z options are specified; thus 
pxp old.p > new.p 

places a pretty-printed version of the program in ‘old.p’ in the file ‘new.p’. 


The use of the following options of pxp is discussed in sections 2.6, 5.4, 5.5 and 5.10 of the Berkeley Pas- 
cal User’s Manual. 


-a Print the bodies of all procedures and functions in the profile; even those which were never exe- 
cuted. 


-c Extract profile data from the file core. 
-d Include declaration parts in a profile. 


-e Eliminate include directives when reformatting a file; the include is replaced by the reformatted 
contents of the specified file. 


-f Fully parenthesize expressions. 
-j Left justify all procedures and functions. 


—n Eject a new page as each file is included; in profiles, print a blank line at the top of the page. 


-s Strip comments from the input text. 
-t Print a table summarizing procedure and function call counts. 
-u Card image mode; only the first 72 characters of input lines are used. 


-w Suppress warning diagnostics. 


-Z Generate an execution profile. If no name s, are given the profile is of the entire program. If a list 
of names is given, then only any specified procedures or functions and the contents of any 


specified include files will appear in the profile. 
- Underline keywords. 


—d With da digit, 2 <d <9, causes pxp to use d spaces as the basic indenting unit. The default is 4. 


FILES 
name.p input file 
name.i include file(s) 
pmon.out profile data 
core profile data source with -c 


/usr/lib/how_pxp information on basic usage 
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SEE ALSO 
Berkeley Pascal User’s Manual 


pi(1), px(1) 
DIAGNOSTICS 
For a basic explanation do 
pxp 
Error diagnostics include ‘No profile data in file’ with the c option if the z option was not enabled to pi; 


‘Not a Pascal system core file’ if the core is not from a px execution; ‘Program and count data do not corre- 
spond’ if the program was changed after compilation, before profiling; or if the wrong program is specified. 


AUTHOR 
William Joy 


BUGS 
Does not place multiple statements per line. 
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NAME 
pxref — Pascal cross-reference program 
SYNOPSIS 
pxref [ — ] name 
DESCRIPTION 
Pxref makes a line numbered listing and a cross-reference of identifier usage for the program in name. The 
optional ‘—’ argument suppresses the listing. The keywords goto and label are treated as identifiers for the 


purpose of the cross-reference. Include directives are not processed, but cause the placement of an entry 
indexed by ‘#include’ in the cross-reference. 


SEE ALSO 
Berkeley Pascal User’s Manual 


AUTHOR 
Niklaus Wirth 


BUGS 
Identifiers are trimmed to 10 characters. 


3rd Berkeley Distribution April 29, 1985 1 


QUOTA(1) UNIX Programmer’s Manual QUOTA (1) 


NAME 

quota — display disc usage and limits 
SYNOPSIS 

quota [ -qv ] [ user ] 
DESCRIPTION 


Quota displays users’ disc usage and limits. Only the super-user may use the optional user argument to 
view the limits of users other than himself. 


The —q flag prints a more terse message, containing only information on file systems where usage is over 
quota. 


If a -v flag is supplied, quota will also display user’s quotas on file systems where no storage is allocated. 


Quota reports only on file systems which have disc quotas. If quota exits with a non-zero status, one or 
more file systems are over quota. 


SEE ALSO 
quota(2), quotaon(8) 
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NAME 

ranlib — convert archives to random libraries 
SYNOPSIS 

ranlib [ -t ] archive ... 
DESCRIPTION 


Ranlib converts each archive to a form which the loader can load more rapidly. Ranlib does this by adding 
a table of contents called _.SYMDEF to the beginning of the archive. Ranlib uses ar(1) to reconstruct the 
archive, so that sufficient temporary file space must be available in the file system which contains the cur- 
rent directory. 


If given the -t option, ranlib only "touches" the archives and does not modify them. This is useful after 
copying an archive or using the -t option of make(1) in order to avoid having /d(1) complain about an ‘‘out 
of date’’ symbol table. 


SEE ALSO 
ld(1), ar(1), lorder(1), make(1) 


BUGS 
Because generation of a library by ar and randomization of the library by ranlib are separate processes, 
phase errors are possible. The loader, /d, warns when the modification date of a library is more recent than 
the creation date of its dictionary; but this means that you get the warning even if you only copy the 
library. 
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NAME 
ratfor — rational Fortran dialect 
SYNOPSIS 
ratfor [ option ... ] [ filename ... ] 
DESCRIPTION 
Ratfor converts a rational dialect of Fortran into ordinary irrational Fortran. Ratfor provides control flow 
constructs essentially identical to those in C: 
statement grouping: 
{ statement; statement; statement } 
decision-making: 
if (condition) statement [ else statement | 
switch (integer value) { 
case integer: statement 
[ default: ] statement 
} 
loops: while (condition) statement 
for (expression; condition; expression) statement 
do limits statement 
repeat statement [ until (condition) ] 
break 
next 
and some syntactic sugar to make programs easier to read and write: 
free form input: 
multiple statements/line; automatic continuation 
comments: 
# this is a comment 
translation of relationals: 
>, >=, etc., become .GT., .GE., etc. 
return (expression) 
returns expression to caller from function 
define: define name replacement 
include: include filename 
Ratfor is best used with f77(1). 
SEE ALSO 


£77(1) 
B. W. Kernighan and P. J. Plauger, Software Tools, Addison-Wesley, 1976. 
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NAME 
rcp — remote file copy 

SYNOPSIS 
rep [ -p ] filel file2 
rep [-p ][-1r ] file ... directory 

DESCRIPTION 
Rcp copies files between machines. Each file or directory argument is either a remote file name of the form 
“‘rhost:path’’, or a local file name (containing no ‘:’ characters, or a ‘/’ before any *:’s). 
If the -r option is specified and any of the source files are directories, rcp copies each subtree rooted at that 
name; in this case the destination must be a directory. 
By default, the mode and owner of file2 are preserved if it already existed; otherwise the mode of the source 
file modified by the umask(2) on the destination host is used. The —p option causes rcp to attempt to pre- 
serve (duplicate) in its copies the modification times and modes of the source files, ignoring the umask. 
If path is not a full path name, it is interpreted relative to your login directory on rhost. A path on a remote 
host may be quoted (using \, ", or *) so that the metacharacters are interpreted remotely. 
Rcp does not prompt for passwords; your current local user name must exist on rhost and allow remote 
command execution via rsh(1C). 
Rcp handles third party copies, where neither source nor target files are on the current machine. Hostnames 
may also take the form “‘rname @rhost’’ to use rname rather than the current user name on the remote host. 
The destination hostname may also take the form “‘rhost.rname’’ to support destination machines that are 
running 4.2BSD versions of rcp. 

SEE ALSO 
cp(1), ftp(1C), rsh(1C), rlogin(1C) 

BUGS 


Doesn’t detect all cases where the target of a copy might be a file in cases where only a directory should be 
legal. 
Is confused by any output generated by commands in a .login, .profile, or .cshre file on the remote host. 
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NAME 


rdist — remote file distribution program 


SYNOPSIS 


rdist [ —nqbRhivwy ] [ -f distfile ] [ -d var=value ] [ —m host ] [ name... ] 
rdist [ —nqbRhivwy ] -c name ... [login@ Jhost[:dest] 


DESCRIPTION 


Rdist is a program to maintain identical copies of files over multiple hosts. It preserves the owner, group, 
mode, and mtime of files if possible and can update programs that are executing. Rdist reads commands 
from distfile to direct the updating of files and/or directories. If distfile is ‘—’, the standard input is used. If 
no -f option is present, the program looks first for “distfile’, then ‘Distfile’ to use as the input. If no names 
are specified on the command line, rdist will update all of the files and directories listed in distfile. Other- 
wise, the argument is taken to be the name of a file to be updated or the label of a command to execute. If 
label and file names conflict, it is assumed to be a label. These may be used together to update specific files 
using specific commands. 


The —c option forces rdist to interpret the remaining arguments as a small distfile. The equivalent distfile is 
as follows. 


(name ... ) -> [login@ ]host 
install [dest] ; 


Other options: 


-d Define var to have value. The —d option is used to define or override variable definitions in the 
distfile. Value can be the empty string, one name, or a list of names surrounded by parentheses 
and separated by tabs and/or spaces. 


—m Limit which machines are to be updated. Multiple -m arguments can be given to limit updates to a 
subset of the hosts listed the distfile . 


—n Print the commands without executing them. This option is useful for debugging distfile. 


-q Quiet mode. Files that are being modified are normally printed on standard output. The —q option 
suppresses this. 


-R Remove extraneous files. If a directory is being updated, any files that exist on the remote host that 
do not exist in the master directory are removed. This is useful for maintaining truely identical 
copies of directories. 


-h Follow symbolic links. Copy the file that the link points to rather than the link itself. 


-i Ignore unresolved links. Rdist will normally try to maintain the link structure of files being trans- 
fered and warn the user if all the links cannot be found. 


-V Verify that the files are up to date on all the hosts. Any files that are out of date will be displayed 
but no files will be changed nor any mail sent. 


-w Whole mode. The whole file name is appended to the destination directory name. Normally, only 
the last component of a name is used when renaming files. This will preserve the directory struc- 
ture of the files being copied instead of flattening the directory structure. For example, renaming a 
list of files such as ( dirl/fl dir2/f2 ) to dir3 would create files dir3/dir1/f1 and dir3/dir2/f2 instead 
of dir3/f1 and dir3/f2. 


-y Younger mode. Files are normally updated if their mtime and size (see stat(2)) disagree. The -—y 
option causes rdist not to update files that are younger than the master copy. This can be used to 
prevent newer copies on other hosts from being replaced. A warning message is printed for files 
which are newer than the master copy. 
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-b Binary comparison. Perform a binary comparison and update files if they differ rather than com- 
paring dates and sizes. 


Distfile contains a sequence of entries that specify the files to be copied, the destination hosts, and what 
operations to perform to do the updating. Each entry has one of the following formats. 


<variable name> ‘=’ <name list> 
[ label: ] <source list> ‘—>’ <destination list> <command list> 
[ label: ] <source list> ‘::’ <time_stamp file> <command list> 


The first format is used for defining variables. The second format is used for distributing files to other 
hosts. The third format is used for making lists of files that have been changed since some given date. The 
source list specifies a list of files and/or directories on the local host which are to be used as the master copy 
for distribution. The destination list is the list of hosts to which these files are to be copied. Each file in the 
source list is added to a list of changes if the file is out of date on the host which is being updated (second 
format) or the file is newer than the time stamp file (third format). 


Labels are optional. They are used to identify a command for partial updates. 


Newlines, tabs, and blanks are only used as separators and are otherwise ignored. Comments begin with ‘#’ 
and end with a newline. 


Variables to be expanded begin with ‘$’ followed by one character or a name enclosed in curly braces (see 
the examples at the end). 


The source and destination lists have the following format: 


<name> 
or 
‘C <zero or more names separated by white-space> ‘)’ 


The shell meta-characters ‘[’, ‘]’, “{’, ‘}’, ‘*’, and ‘?’ are recognized and expanded (on the local host only) 
in the same way as csh(1). They can be escaped with a backslash. The *’ character is also expanded in the 
same way as csh but is expanded separately on the local and destination hosts. When the —w option is used 
with a file name that begins with “’, everything except the home directory is appended to the destination 
name. File names which do not begin with ‘/ or “’ use the destination user’s home directory as the root 
directory for the rest of the file name. 


The command list consists of zero or more commands of the following format. 


‘install’ <options> opt _dest_name ‘;’ 
‘notify’ <name list>‘;’ 

‘except’ <name list>‘;’ 

‘except_pat’ <pattern list>‘;’ 
‘special’<name list>string *;’ 


The install command is used to copy out of date files and/or directories. Each source file is copied to each 
host in the destination list. Directories are recursively copied in the same way. Opt_dest_name is an 
optional parameter to rename files. If no install command appears in the command list or the destination 
name is not specified, the source file name is used. Directories in the path name will be created if they do 
not exist on the remote host. To help prevent disasters, a non-empty directory on a target host will never be 
replaced with a regular file or a symbolic link. However, under the “-R’ option a non-empty directory will 
be removed if the corresponding filename is completely absent on the master host. The options are ‘“-R’, 
“h’, *-i’, ‘-v’, ‘-w’, ‘“-y’, and ‘—b’ and have the same semantics as options on the command line except 
they only apply to the files in the source list. The login name used on the destination host is the same as the 
local host unless the destination name is of the format ‘‘login@host". 
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FILES 


The notify command is used to mail the list of files updated (and any errors that may have occured) to the 
listed names. If no ‘@’ appears in the name, the destination host is appended to the name (e.g., 
name! @host, name2 @host, ...). 


The except command is used to update all of the files in the source list except for the files listed in name 
list. This is usually used to copy everything in a directory except certain files. 


The except_pat command is like the except command except that pattern list is a list of regular expressions 
(see ed(1) for details). If one of the patterns matches some string within a file name, that file will be 
ignored. Note that since ‘\’ is a quote character, it must be doubled to become part of the regular expres- 
sion. Variables are expanded in pattern list but not shell file pattern matching characters. To include a ‘$’, 
it must be escaped with ‘\’. 


The special command is used to specify sh(1) commands that are to be executed on the remote host after 
the file in name list is updated or installed. If the name list is omitted then the shell commands will be exe- 
cuted for every file updated or installed. The shell variable ‘FILE’ is set to the current filename before exe- 
cuting the commands in string. String starts and ends with ‘"’ and can cross multiple lines in distfile. Mul- 
tiple commands to the shell should be separated by ‘;’. Commands are executed in the user’s home direc- 
tory on the host being updated. The special command can be used to rebuild private databases, etc. after a 
program has been updated. 


The following is a small example. 
HOSTS = ( matisse root @arpa) 


FILES = ( /bin /lib /usr/bin /usr/games 
/usr/include/{ *.h,{stand,sys,vax*,pascal,machine }/*.h} 
/usr/lib /usr/man/man? /usr/ucb /usr/local/rdist ) 


EXLIB = ( Mail.re aliases aliases.dir aliases.pag crontab dshre 
sendmail.cf sendmail.fc sendmail.hf sendmail.st uucp vfont ) 


${FILES} -> ${HOSTS} 
install -R ; 
except /usr/lib/${EXLIB} ; 
except /usr/games/lib ; 
special /usr/lib/sendmail "/usr/lib/sendmail -bz" ; 


SIcs: 
/usr/src/bin -> arpa 
except_pat (\\.o\$ /SCCS\S ) ; 


IMAGEN = (ips dviimp catdvi) 

imagen: 

/usr/local/$ {IMAGEN } -> arpa 
install /usr/local/lib ; 


notify ralph ; 


${ FILES} :: stamp.cory 
notify root@ cory ; 


distfile input command file 
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/tmp/rdist* temporary file for update lists 


SEE ALSO 
sh(1), csh(1), stat(2) 


DIAGNOSTICS 
A complaint about mismatch of rdist version numbers may really stem from some problem with starting 
your shell, e.g., you are in too many groups. 


BUGS 
Source files must reside on the local host where rdist is executed. 


There is no easy way to have a special command executed after all files in a directory have been updated. 
Variable expansion only works for name lists; there should be a general macro facility. 
Rdist aborts on files which have a negative mtime (before Jan 1, 1970). 


There should be a ‘force’ option to allow replacement of non-empty directories by regular files or symlinks. 
A means of updating file modes and owners of otherwise identical files is also needed. 
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NAME 
refer — find and insert literature references in documents 


SYNOPSIS 
refer [-a ][-b ] [-c] [-e ] [-fa ] [-kx ] [-Im,n ] [-n ] [ -p bib ] [ -skeys ] [-Blim ] | -P ] [-S] [ file 
| 


DESCRIPTION 
Refer is a preprocessor for nroff or troff(1) that finds and formats references for footnotes or endnotes. It is 
also the base for a series of programs designed to index, search, sort, and print stand-alone bibliographies, 
or other data entered in the appropriate form. 


Given an incomplete citation with sufficiently precise keywords, refer will search a bibliographic database 
for references containing these keywords anywhere in the title, author, journal, etc. The input file (or stan- 
dard input) is copied to standard output, except for lines between .[ and .] delimiters, which are assumed to 
contain keywords, and are replaced by information from the bibliographic database. The user may also 
search different databases, override particular fields, or add new fields. The reference data, from whatever 
source, are assigned to a set of troff strings. Macro packages such as ms(7) print the finished reference text 
from these strings. By default references are flagged by footnote numbers. 


The following options are available: 


-an Reverse the first nm author names (Jones, J. A. instead of J. A. Jones). If is omitted all author 
names are reversed. 


—b Bare mode: do not put any flags in text (neither numbers nor labels). 
—ckeys Capitalize (with CAPS SMALL Caps) the fields whose key-letters are in keys. 


-e Instead of leaving the references where encountered, accumulate them until a sequence of the form 
[ 
$LIST$ 
| 
is encountered, and then write out all references collected so far. Collapse references to same 
source. 


-fn Set the footnote number to n instead of the default of 1 (one). With labels rather than numbers, this 
flag is a no-op. 


-kx Instead of numbering references, use labels as specified in a reference data line beginning %x; by 
default x is L. 


-Im,n Instead of numbering references, use labels made from the senior author’s last name and the year of 
publication. Only the first m letters of the last name and the last n digits of the date are used. If 
either m or 1 is omitted the entire name or date respectively is used. 


—n Do not search the default file /usr/dict/papers/Ind. If there is a REFER environment variable, the 
specified file will be searched instead of the default file; in this case the —n flag has no effect. 

—p bib 
Take the next argument bib as a file of references to be searched. The default file is searched last. 

-skeys Sort references by fields whose key-letters are in the keys string; permute reference numbers in text 
accordingly. Implies -e. The key-letters in keys may be followed by a number to indicate how 


many such fields are used, with + taken as a very large number. The default is AD which sorts on 
the senior author and then date; to sort, for example, on all authors and then title, use -sA+T. 


-Bl.m Bibliography mode. Take a file composed of records separated by blank lines, and turn them into 
troff input. Label / will be turned into the macro .m with / defaulting to %X and .m defaulting to 
-AP (annotation paragraph). 
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-P Place punctuation marks .,:;?! after the reference signal, rather than before. (Periods and commas 
used to be done with strings.) 


-S Produce references in the Natural or Social Science format. 


To use your own references, put them in the format described below. They can be searched more rapidly 
by running indxbib(1) on them before using refer; failure to index results in a linear search. When refer is 
used with the eqn, neqn or tbl preprocessors refer should be first, to minimize the volume of data passed 
through pipes. 


The refer preprocessor and associated programs expect input from a file of references composed of records 
separated by blank lines. A record is a set of lines (fields), each containing one kind of information. Fields 
start on a line beginning with a ‘*%’’, followed by a key-letter, then a blank, and finally the contents of the 
field, and continue until the next line starting with ‘‘%’’. The output ordering and formatting of fields is 
controlled by the macros specified for nroff/troff (for footnotes and endnotes) or roffbib (for stand-alone 
bibliographies). For a list of the most common key-letters and their corresponding fields, see addbib(1). 
An example of a refer entry is given below. 


EXAMPLE 


%A M. E. Lesk 

%T Some Applications of Inverted Indexes on the UNIX System 
%B UNIX Programmer’s Manual 

YN 2b 

%oI Bell Laboratories 

%C Murray Hill, NJ 


%D 1978 
FILES 
/usr/dict/papers directory of default publication lists 
/usr/lib/refer directory of companion programs 
SEE ALSO 
addbib(1), sortbib(1), roffbib(1), indxbib(1), lookbib(1) 
AUTHOR 
Mike Lesk 
BUGS 


Blank spaces at the end of lines in bibliography fields will cause the records to sort and reverse incorrectly. 
Sorting large numbers of references causes a core dump. 
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NAME 
rev — reverse lines of a file 


SYNOPSIS 
rev [ file ] ... 


DESCRIPTION 
Rev copies the named files to the standard output, reversing the order of characters in every line. If no file 
is specified, the standard input is copied. 
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NAME 


rlogin — remote login 


SYNOPSIS 


rlogin rhost [ -ec ] [-8 ] [-L ] [-l username ] 
rhost [ -ec ] [ -8 ] [-L ] [-1 username ] 


DESCRIPTION 


Rlogin connects your terminal on the current local host system /host to the remote host system rhost. 


Each host has a file /etc/hosts.equiv which contains a list of rhost’s with which it shares account names. 
(The host names must be the standard names as described in rsh(1C).) When you rlogin as the same user 
on an equivalent host, you don’t need to give a password. Each user may also have a private equivalence 
list in a file .rhosts in his login directory. Each line in this file should contain an rhost and a username sepa- 
rated by a space, giving additional cases where logins without passwords are to be permitted. If the origi- 
nating user is not equivalent to the remote user, then a login and password will be prompted for on the 
remote machine as in login(1). To avoid some security problems, the .rhosts file must be owned by either 
the remote user or root. 


The remote terminal type is the same as your local terminal type (as given in your environment TERM vari- 
able). The terminal or window size is also copied to the remote system if the server supports the option, 
and changes in size are reflected as well. All echoing takes place at the remote site, so that (except for 
delays) the rlogin is transparent. Flow control via *S and “Q and flushing of input and output on interrupts 
are handled properly. The optional argument -8 allows an eight-bit input data path at all times; otherwise 
parity bits are stripped except when the remote side’s stop and start characters are other than “S/°Q. The 
argument —L allows the rlogin session to be run in litout mode. A line of the form ‘*~.’’ disconnects from 
the remote host, where ‘*’’ is the escape character. Similarly, the line ‘“*Z’’ (where *Z, control-Z, is the 
suspend character) will suspend the rlogin session. Substitution of the delayed-suspend character (normally 
“Y) for the suspend character suspends the send portion of the rlogin, but allows output from the remote 
system. A different escape character may be specified by the -e option. There is no space separating this 
option flag and the argument character. 


SEE ALSO 

rsh(1C) 
FILES 

/usr/hosts/* for rhost version of the command 
BUGS 


More of the environment should be propagated. 
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NAME 

rm, rmdir — remove (unlink) files or directories 
SYNOPSIS 

rm[-f][-r][-i][-] file... 

rmdir dir ... 
DESCRIPTION 


Rm removes the entries for one or more files from a directory. If an entry was the last link to the file, the 
file is destroyed. Removal of a file requires write permission in its directory, but neither read nor write per- 
mission on the file itself. 


If a file has no write permission and the standard input is a terminal, its permissions are printed and a line is 
read from the standard input. If that line begins with ‘y’ the file is deleted, otherwise the file remains. No 
questions are asked and no errors are reported when the -f (force) option is given. 


If a designated file is a directory, an error comment is printed unless the optional argument -r has been 
used. In that case, rm recursively deletes the entire contents of the specified directory, and the directory 
itself. 


If the -i (interactive) option is in effect, rm asks whether to delete each file, and, under -r, whether to 
examine each directory. 


The null option — indicates that all the arguments following it are to be treated as file names. This allows 
the specification of file names starting with a minus. 


Rmdir removes entries for the named directories, which must be empty. 


SEE ALSO 
rm(1), unlink(2), rmdir(2) 
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NAME 
rmail — handle remote mail received via uucp 


SYNOPSIS 
rmail user ... 


DESCRIPTION 
Rmail interprets incoming mail received via uucp(1C), collapsing ‘‘From’’ lines in the form generated by 


binmail(1) into a single line of the form ‘‘return-path!sender’’, and passing the processed mail on to send- 
mail(8). 


Rmail is explicitly designed for use with uucp and sendmail. 


SEE ALSO 
binmail(1), uucp(1C), sendmail(8) 


BUGS 
Rmail should not reside in /bin. 
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NAME 

rmdir, rm — remove (unlink) directories or files 
SYNOPSIS 

rmdir dir ... 

rm[-f][-r][-i][-] file... 
DESCRIPTION 


Rmdir removes entries for the named directories, which must be empty. 


Rm removes the entries for one or more files from a directory. If an entry was the last link to the file, the 
file is destroyed. Removal of a file requires write permission in its directory, but neither read nor write per- 
mission on the file itself. 


If a file has no write permission and the standard input is a terminal, its permissions are printed and a line is 
read from the standard input. If that line begins with ‘y’ the file is deleted, otherwise the file remains. No 
questions are asked and no errors are reported when the -f (force) option is given. 


If a designated file is a directory, an error comment is printed unless the optional argument —-r has been 
used. In that case, rm recursively deletes the entire contents of the specified directory, and the directory 
itself. 


If the -i (interactive) option is in effect, rm asks whether to delete each file, and, under -r, whether to 
examine each directory. 


The null option — indicates that all the arguments following it are to be treated as file names. This allows 
the specification of file names starting with a minus. 


SEE ALSO 
rm(1), unlink(2), rmdir(2) 
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NAME 


roffbib — run off bibliographic database 


SYNOPSIS 


roffbib [-e ][-h ][-n] [-o] [-r][-s ][-Tterm ] [| -x ] [-mmac ][-V ][-Q] [file ... ] 


DESCRIPTION 


FILES 


Roffbib prints out all records in a bibliographic database, in bibliography format rather than as footnotes or 
endnotes. Generally it is used in conjunction with sortbib: 


sortbib database | roffbib 


Roffbib accepts most of the options understood by nroff(1), most importantly the -T flag to specify termi- 
nal type. 


If abstracts or comments are entered following the %X field key, roffbib will format them into paragraphs 
for an annotated bibliography. Several %X fields may be given if several annotation paragraphs are 
desired. The -x flag will suppress the printing of these abstracts. 


A user-defined set of macros may be specified after the -m option. There should be a space between the 
—m and the macro filename. This set of macros will replace the ones defined in /usr/lib/tmac/tmac.bib. The 
-V flag will send output to the Versatec; the -Q flag will queue output for the phototypesetter. 


Four command-line registers control formatting style of the bibliography, much like the number registers of 
ms(7). The command-line argument -rN1 will number the references starting at one (1). The flag -rV2 
will double space the bibliography, while -rV1 will double space references but single space annotation 
paragraphs. The line length can be changed from the default 6.5 inches to 6 inches with the —-rL6i argu- 
ment, and the page offset can be set from the default of 0 to one inch by specifying -rO1i (capital O, not 
zero). Note: with the -V and —Q flags the default page offset is already one inch. 


/usr/lib/tmac/tmac.bib file of macros used by nroff/troff 


SEE ALSO 


BUGS 


refer(1), addbib(1), sortbib(1), indxbib(1), lookbib(1) 


Users have to rewrite macros to create customized formats. 
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NAME 
rsh — remote shell 


SYNOPSIS 
rsh host [ -l username ] [ —n ] command 
host [ -l username | [ —n ] command 


DESCRIPTION 
Rsh connects to the specified host, and executes the specified command. Rsh copies its standard input to the 
remote command, the standard output of the remote command to its standard output, and the standard error 
of the remote command to its standard error. Interrupt, quit and terminate signals are propagated to the 
remote command; rsh normally terminates when the remote command does. 


The remote username used is the same as your local username, unless you specify a different remote name 
with the -] option. This remote name must be equivalent (in the sense of rlogin(1C)) to the originating 
account; no provision is made for specifying a password with a command. 


If you omit command, then instead of executing a single command, you will be logged in on the remote 
host using rlogin(1C). 


Shell metacharacters which are not quoted are interpreted on local machine, while quoted metacharacters 
are interpreted on the remote machine. Thus the command 


rsh otherhost cat remotefile >> localfile 

appends the remote file remotefile to the localfile localfile, while 
rsh otherhost cat remotefile ">>" otherremotefile 

appends remotefile to otherremotefile. 


Host names are given in the file /etc/hosts. Each host has one standard name (the first name given in the 
file), which is rather long and unambiguous, and optionally one or more nicknames. The host names for 
local machines are also commands in the directory /usr/hosts; if you put this directory in your search path 
then the rsh can be omitted. 


FILES 
/etc/hosts 
/usr/hosts/* 
SEE ALSO 
rlogin(1C) 
BUGS 


If you are using csh(1) and put a rsh(1C) in the background without redirecting its input away from the ter- 
minal, it will block even if no reads are posted by the remote command. If no input is desired you should 
redirect the input of rsh to /dev/null using the —n option. 


You cannot run an interactive command (like rogue (6) or vi(1)); use rlogin(1C). 


Stop signals stop the local rsh process only; this is arguably wrong, but currently hard to fix for reasons too 
complicated to explain here. 
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NAME 

ruptime — show host status of local machines 
SYNOPSIS 

ruptime [-a | [-r][-l][-t][-w] 
DESCRIPTION 


Ruptime gives a status line like uptime for each machine on the local network; these are formed from pack- 
ets broadcast by each host on the network once a minute. 


Machines for which no status report has been received for 11 minutes are shown as being down. 
Users idle an hour or more are not counted unless the —a flag is given. 


Normally, the listing is sorted by host name. The -1 , -t , and -u flags specify sorting by load average, 
uptime, and number of users, respectively. The -r flag reverses the sort order. 


FILES 

/ust/spool/rwho/whod.* data files 
SEE ALSO 

rwho(1C) 
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NAME 
rwho — who’s logged in on local machines 


SYNOPSIS 
rwho [ —a ] 

DESCRIPTION 
The rwho command produces output similar to who, but for all machines on the local network. If no report 
has been received from a machine for 5 minutes then rwho assumes the machine is down, and does not 
report users last known to be logged into that machine. 


If a users hasn’t typed to the system for a minute or more, then rwho reports this idle time. If a user hasn’t 
typed to the system for an hour or more, then the user will be omitted from the output of rwho unless the —a 
flag is given. 


FILES 
/ust/spool/rwho/whod.* information about other machines 


SEE ALSO 
ruptime(1C), rwhod(8C) 


BUGS 
This is unwieldy when the number of machines on the local net is large. 
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NAME 


UNIX Programmer’s Manual SCCS (1) 


secs — front end for the SCCS subsystem 


SYNOPSIS 


secs [ -r ] [-dpath | [ -ppath ] command [ flags ] [ args ] 


DESCRIPTION 


Sccs is a front end to the SCCS programs that helps them mesh more cleanly with the rest of UNIX. It also 
includes the capability to run “‘set user id’’ to another user to provide additional protection. 


Basically, sccs runs the command with the specified flags and args. Each argument is normally modified to 
be prepended with ‘‘SCCS/s.’’. 


Flags to be interpreted by the sccs program must be before the command argument. Flags to be passed to 
the actual SCCS program must come after the command argument. These flags are specific to the command 
and are discussed in the documentation for that command. 


Besides the usual SCCS commands, several ‘‘pseudo-commands’”’ can be issued. These are: 


edit 


delget 


deledit 


create 


clean 


unedit 


info 


check 


tell 


diffs 
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Equivalent to ‘‘get -e’’. 


Perform a delta on the named files and then get new versions. The new versions will 
have id keywords expanded, and will not be editable. The —m, —p, -r, —s, and —y flags 
will be passed to delta, and the —b, —c, -e, —i, —k, 1, -s, and —x flags will be passed to get. 


Equivalent to ‘‘delget’’ except that the ‘‘get’’ phase includes the ‘‘—e’’ flag. This option 
is useful for making a ‘‘checkpoint’’ of your current editing phase. The same flags will 
be passed to delta as described above, and all the flags listed for ‘‘get’’ above except —e 
and —k are passed to ‘‘edit’’. 


Creates an SCCS file, taking the initial contents from the file of the same name. Any flags 
to ‘‘admin’’ are accepted. If the creation is successful, the files are renamed with a 
comma on the front. These should be removed when you are convinced that the SCCS 
files have been created successfully. 


Must be followed by a -r flag. This command essentially removes the named delta, but 
leaves you with a copy of the delta with the changes that were in it. It is useful for fixing 
small compiler bugs, etc. Since it doesn’t leave audit trails, it should be used carefully. 


This routine removes everything from the current directory that can be recreated from 
SCCS files. It will not remove any files being edited. If the -b flag is given, branches are 
ignored in the determination of whether they are being edited; this is dangerous if you are 
keeping the branches in the same directory. 


This is the opposite of an ‘“‘edit’’ or a “‘get -e’’. It should be used with extreme caution, 
since any changes you made since the get will be irretrievably lost. 


Gives a listing of all files being edited. If the —b flag is given, branches (i.e., SID’s with 
two or fewer components) are ignored. If the —u flag is given (with an optional argu- 
ment) then only files being edited by you (or the named user) are listed. 


Like ‘‘info’’ except that nothing is printed if nothing is being edited, and a non-zero exit 
status is returned if anything is being edited. The intent is to have this included in an 
‘install’ entry in a makefile to insure that everything is included into the SCCS file 
before a version is installed. 


Gives a newline-separated list of the files being edited on the standard output. Takes the 
—b and -u flags like “‘info’’ and ‘‘check’’. 


Gives a ‘‘diff’’ listing between the current version of the program(s) you have out for 
editing and the versions in SCCS format. The -r, -c, -i, —x, and -t flags are passed to get; 
the -l, -s, -e, -f, -h, and —b options are passed to diff: The -C flag is passed to diff as -c. 
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print This command prints out verbose information about the named files. 


The -r flag runs sccs as the real user rather than as whatever effective user sccs is ‘‘set user id’’ to. The -d 
flag gives a root directory for the SCCS files. The default is the current directory. The —p flag defines the 
pathname of the directory in which the SCCS files will be found; ‘‘SCCS”’ is the default. The —p flag dif- 
fers from the —d flag in that the -d argument is prepended to the entire pathname and the —p argument is 
inserted before the final component of the pathname. For example, ‘‘sccs -d/x —py get a/b’’ will convert to 
“*get /x/a/y/s.b’’. The intent here is to create aliases such as ‘‘alias syssccs sccs -d/usr/src’’ which will be 
used as “‘syssccs get cmd/who.c’’. Also, if the environment variable PROJECT is set, its value is used to 
determine the -d flag. If it begins with a slash, it is taken directly; otherwise, the home directory of a user 
of that name is examined for a subdirectory “‘src’’ or ‘‘source’’. If such a directory is found, it is used. 


Certain commands (such as admin) cannot be run “‘set user id’’ by all users, since this would allow anyone 
to change the authorizations. These commands are always run as the real user. 


EXAMPLES 
To get a file for editing, edit it, and produce a new delta: 


sccs get -e file.c 
ex file.c 
secs delta file.c 


To get a file from another directory: 
secs —p/usr/src/sccs/s. get cc.c 
or 
sccs get /usr/src/sccs/s.cc.c 
To make a delta of a large number of files in the current directory: 
sccs delta *.c 
To get a list of files being edited that are not on branches: 
secs info —b 
To delta everything being edited by you: 
sccs delta “sccs tell —u" 
In a makefile, to get source files from an SCCS file if it does not already exist: 


SRCS = <list of source files> 
$(SRCS): 
sccs get $(REL) $@ 
SEE ALSO 
admin(SCCS), chghist(SCCS), comb(SCCS), delta(SCCS), get(SCCS), help(SCCS), prt(SCCS), 
rmdel(SCCS), sccsdiff(SCCS), what(SCCS) 
Eric Allman, An Introduction to the Source Code Control System 


BUGS 
It should be able to take directory arguments on pseudo-commands like the SCCS commands do. 
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NAME 
script — make typescript of terminal session 


SYNOPSIS 
script [ -a ] [ file ] 


DESCRIPTION 
Script makes a typescript of everything printed on your terminal. The typescript is written to file, or 
appended to file if the —a option is given. It can be sent to the line printer later with /pr. If no file name is 
given, the typescript is saved in the file typescript. 


The script ends when the forked shell exits. 


This program is useful when using a crt and a hard-copy record of the dialog is desired, as for a student 
handing in a program that was developed on a crt when hard-copy terminals are in short supply. 


BUGS 
Script places everything in the log file. This is not what the naive user expects. 
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NAME 
sed — stream editor 


SYNOPSIS 
sed [ —n ] [-e script ] [ -f sfile ] [ file ] ... 


DESCRIPTION 
Sed copies the named files (standard input default) to the standard output, edited according to a script of 
commands. The -f option causes the script to be taken from file sfile; these options accumulate. If there is 
just one —-e option and no -f’s, the flag -e may be omitted. The —n option suppresses the default output. 


A script consists of editing commands, one per line, of the following form: 
[address [, address] ] function [arguments] 


In normal operation sed cyclically copies a line of input into a pattern space (unless there is something left 
after a ‘D’ command), applies in sequence all commands whose addresses select that pattern space, and at 
the end of the script copies the pattern space to the standard output (except under —n) and deletes the pattern 
space. 


An address is either a decimal number that counts input lines cumulatively across files, a ‘$’ that addresses 
the last line of input, or a context address, ‘/regular expression/’, in the style of ed(1) modified thus: 


The escape sequence ‘\n’ matches a newline embedded in the pattern space. 
A command line with no addresses selects every pattern space. 
A command line with one address selects each pattern space that matches the address. 


A command line with two addresses selects the inclusive range from the first pattern space that matches the 
first address through the next pattern space that matches the second. (If the second address is a number less 
than or equal to the line number first selected, only one line is selected.) Thereafter the process is repeated, 
looking again for the first address. 


Editing commands can be applied only to non-selected pattern spaces by use of the negation function ‘!’ 
(below). 
In the following list of functions the maximum number of permissible addresses for each function is indi- 


cated in parentheses. 


An argument denoted text consists of one or more lines, all but the last of which end with ‘V to hide the 
newline. Backslashes in text are treated like backslashes in the replacement string of an ‘s’ command, and 
may be used to protect initial blanks and tabs against the stripping that is done on every script line. 


An argument denoted rfile or wfile must terminate the command line and must be preceded by exactly one 
blank. Each wfile is created before processing begins. There can be at most 10 distinct wfile arguments. 


(1)a\ 
text 
Append. Place text on the output before reading the next input line. 


(2) b label 
Branch to the *:’ command bearing the label. If label is empty, branch to the end of the script. 


(2) c\ 

text 
Change. Delete the pattern space. With 0 or | address or at the end of a 2-address range, place 
text on the output. Start the next cycle. 


(2)d Delete the pattern space. Start the next cycle. 


(2)D Delete the initial segment of the pattern space through the first newline. Start the next cycle. 
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(2)g Replace the contents of the pattern space by the contents of the hold space. 
(2)G Append the contents of the hold space to the pattern space. 

(2)h Replace the contents of the hold space by the contents of the pattern space. 
(2)H — Append the contents of the pattern space to the hold space. 

(1)i\ 


text 
Insert. Place text on the standard output. 


(2)n Copy the pattern space to the standard output. Replace the pattern space with the next line of 
input. 

(2)N Append the next line of input to the pattern space with an embedded newline. (The current line 
number changes.) 

(2)p Print. Copy the pattern space to the standard output. 

(2)P Copy the initial segment of the pattern space through the first newline to the standard output. 

(1)q Quit. Branch to the end of the script. Do not start a new cycle. 

(2)r rfile 
Read the contents of rfile. Place them on the output before reading the next input line. 


(2) s/regular expression/replacement/flags 
Substitute the replacement string for instances of the regular expression in the pattern space. Any 
character may be used instead of ‘/’. For a fuller description see ed(1). Flags is zero or more of 


g Global. Substitute for all nonoverlapping instances of the regular expression rather than 
just the first one. 


p Print the pattern space if a replacement was made. 
w wfile Write. Append the pattern space to wfile if a replacement was made. 


(2)t label 
Test. Branch to the ‘:’ command bearing the /abel if any substitutions have been made since the 
most recent reading of an input line or execution of a ‘t’. If Jabel is empty, branch to the end of 
the script. 

(2) w wfile 
Write. Append the pattern space to wile. 


(2)x Exchange the contents of the pattern and hold spaces. 
(2) y/string I/string2/ 


Transform. Replace all occurrences of characters in string] with the corresponding character in 
string2. The lengths of string] and string2 must be equal. 


(2)! function 
Don’t. Apply the function (or group, if function is ‘{’) only to lines not selected by the 


address(es). 
(0) : label 
This command does nothing; it bears a label for “b’ and ‘t’ commands to branch to. 
()= Place the current line number on the standard output as a line. 
(2) { Execute the following commands through a matching ‘}’ only when the pattern space is selected. 
(0) An empty command is ignored. 
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SEE ALSO 
ed(1), grep(1), awk(1), lex(1) 
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NAME 

sendbug — mail a system bug report to 4bsd-bugs 
SYNOPSIS 

sendbug [ address ] 
DESCRIPTION 


Bug reports sent to ‘4bsd-bugs@Berkeley.EDU’ are intercepted by a program which expects bug reports to 
conform to a standard format. Sendbug is a shell script to help the user compose and mail bug reports in 
the correct format. Sendbug works by invoking the editor specified by the environment variable EDITOR 
on a temporary copy of the bug report format outline. The user must fill in the appropriate fields and exit 
the editor. The default editor is vi(1). Sendbug then mails the completed report to ‘“4bsd- 
bugs @Berkeley.EDU’ or the address specified on the command line. 


FILES 
/usr/ucb/bugformat contains the bug report outline 


SEE ALSO 
vi(1), environ(7), sendmail(8) 
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NAME 
sh, for, case, if, while, :, ., break, continue, cd, eval, exec, exit, export, login, read, readonly, set, shift, 
times, trap, umask, wait — command language 


SYNOPSIS 
sh [ -ceiknrstuvx ] [ arg ] ... 


DESCRIPTION 
Sh is a command programming language that executes commands read from a terminal or a file. See invo- 
cation for the meaning of arguments to the shell. 


Commands. 

A simple-command is a sequence of non blank words separated by blanks (a blank is a tab or a space). The 
first word specifies the name of the command to be executed. Except as specified below the remaining 
words are passed as arguments to the invoked command. The command name is passed as argument 0 (see 
execve(2)). The value of a simple-command is its exit status if it terminates normally or 200+status if it 
terminates abnormally (see sigvec(2) for a list of status values). 


A pipeline is a sequence of one or more commands separated by |. The standard output of each command 
but the last is connected by a pipe(2) to the standard input of the next command. Each command is run as a 
separate process; the shell waits for the last command to terminate. 


A list is a sequence of one or more pipelines separated by ;, & && or || and optionally terminated by ; or 
&. ; and & have equal precedence which is lower than that of && and ||, && and || also have equal prece- 
dence. A semicolon causes sequential execution; an ampersand causes the preceding pipeline to be exe- 
cuted without waiting for it to finish. The symbol && (||) causes the list following to be executed only if 
the preceding pipeline returns a zero (non zero) value. Newlines may appear in a list, instead of semi- 
colons, to delimit commands. 


A command is either a simple-command or one of the following. The value returned by a command is that 
of the last simple-command executed in the command. 


for name [in word ... | do list done 
Each time a for command is executed name is set to the next word in the for word list. If in word 
. is omitted, in "$@"' is assumed. Execution ends when there are no more words in the list. 


case word in [ pattern [ | pattern |... ) list 33] ... esac 
A case command executes the /ist associated with the first pattern that matches word. The form of 
the patterns is the same as that used for file name generation. 


if list then list [ elif list then list] ... [else list ] fi 
The list following if is executed and if it returns zero the list following then is executed. Other- 
wise, the list following elif is executed and if its value is zero the list following then is executed. 
Failing that the else /ist is executed. 


while list [ do list ] done 
A while command repeatedly executes the while /ist and if its value is zero executes the do list; 
otherwise the loop terminates. The value returned by a while command is that of the last executed 
command in the do Jist. until may be used in place of while to negate the loop termination test. 


(list ) Execute list in a subshell. 

{ list} list is simply executed. 

The following words are only recognized as the first word of a command and when not quoted. 
if then else elif fi case in esac for while until do done { } 


Command substitution. 
The standard output from a command enclosed in a pair of back quotes ( ~) may be used as part or all of a 
word; trailing newlines are removed. 
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Parameter substitution. 
The character $ is used to introduce substitutable parameters. Positional parameters may be assigned values 
by set. Variables may be set by writing 


name=value [ name=value | ... 


$ {parameter } 
A parameter is a sequence of letters, digits or underscores (a name), a digit, or any of the charac- 
ters * @ #?-—$!. The value, if any, of the parameter is substituted. The braces are required only 
when parameter is followed by a letter, digit, or underscore that is not to be interpreted as part of 
its name. If parameter is a digit, it is a positional parameter. If parameter is * or @ then all the 
positional parameters, starting with $1, are substituted separated by spaces. $0 is set from argu- 
ment zero when the shell is invoked. 


$ {parameter—word } 
If parameter is set, substitute its value; otherwise substitute word. 


$ {parameter=word } 
If parameter is not set, set it to word; the value of the parameter is then substituted. Positional 
parameters may not be assigned to in this way. 


$ {parameter ? word } 
If parameter is set, substitute its value; otherwise, print word and exit from the shell. If word is 
omitted, a standard message is printed. 


$ {parameter+word } 
If parameter is set, substitute word; otherwise substitute nothing. 


In the above word is not evaluated unless it is to be used as the substituted string. (So that, for example, 
echo ${d—“pwd’} will only execute pwd if d is unset.) 


The following parameters are automatically set by the shell. 


# The number of positional parameters in decimal. 

Options supplied to the shell on invocation or by set. 

The value returned by the last executed command in decimal. 
The process number of this shell. 

The process number of the last background command invoked. 


FAs | 


The following parameters are used but not set by the shell. 


HOME The default argument (home directory) for the cd command. 

PATH The search path for commands (see execution). 

MAIL If this variable is set to the name of a mail file, the shell informs the user of the arrival of 
mail in the specified file. 

PS1 Primary prompt string, by default ’$ ’. 

PS2 Secondary prompt string, by default ’>’. 

IFS Internal field separators, normally space, tab, and newline. IFS is ignored if sh is run- 
ning as root or if the effective user id differs from the real user id. 


Blank interpretation. 

After parameter and command substitution, any results of substitution are scanned for internal field separa- 
tor characters (those found in $IFS) and split into distinct arguments where such characters are found. 
Explicit null arguments ("" or *’) are retained. Implicit null arguments (those resulting from parameters 
that have no values) are removed. 


File name generation. 

Following substitution, each command word is scanned for the characters *, ? and [. If one of these charac- 
ters appears, the word is regarded as a pattern. The word is replaced with alphabetically sorted file names 
that match the pattern. If no file name is found that matches the pattern, the word is left unchanged. The 
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character . at the start of a file name or immediately following a /, and the character /, must be matched 


explicitly. 

* Matches any string, including the null string. 

? Matches any single character. 

[...] Matches any one of the characters enclosed. A pair of characters separated by — matches any char- 


acter lexically between the pair. 


Quoting. 
The following characters have a special meaning to the shell and cause termination of a word unless quoted. 


3; & ( ) | < > newline space tab 


A character may be quoted by preceding it with a \. \newline is ignored. All characters enclosed between 
a pair of quote marks (**), except a single quote, are quoted. Inside double quotes (""') parameter and 
command substitution occurs and \ quotes the characters \ “" and $. 


"$«" is equivalent to "$1 $2..." whereas 
"$@"' is equivalent to "$1" "$2"... 


Prompting. 

When used interactively, the shell prompts with the value of PS1 before reading a command. If at any time 
a newline is typed and further input is needed to complete a command, the secondary prompt ($PS2) is 
issued. 


Input output. 

Before a command is executed its input and output may be redirected using a special notation interpreted by 
the shell. The following may appear anywhere in a simple-command or may precede or follow a command 
and are not passed on to the invoked command. Substitution occurs before word or digit is used. 


<word Use file word as standard input (file descriptor 0). 


>word Use file word as standard output (file descriptor 1). If the file does not exist, it is created; other- 
wise it is truncated to zero length. 


>>word Use file word as standard output. If the file exists, output is appended (by seeking to the end); oth- 
erwise the file is created. 


<<word The shell input is read up to a line the same as word, or end of file. The resulting document 
becomes the standard input. If any character of word is quoted, no interpretation is placed upon 
the characters of the document; otherwise, parameter and command substitution occurs, \newline 
is ignored, and \ is used to quote the characters \ $ ’ and the first character of word. 


<& digit 
The standard input is duplicated from file descriptor digit; see dup(2). Similarly for the standard 
output using >. 

<&— The standard input is closed. Similarly for the standard output using >. 


If one of the above is preceded by a digit, the file descriptor created is that specified by the digit (instead of 
the default 0 or 1). For example, 


. 2>&1 
creates file descriptor 2 to be a duplicate of file descriptor 1. 


If a command is followed by & then the default standard input for the command is the empty file 
(/dev/null). Otherwise, the environment for the execution of a command contains the file descriptors of the 
invoking shell as modified by input output specifications. 


Environment. 
The environment is a list of name-value pairs that is passed to an executed program in the same way as a 
normal argument list; see execve(2) and environ(7). The shell interacts with the environment in several 
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ways. On invocation, the shell scans the environment and creates a parameter for each name found, giving 
it the corresponding value. Executed commands inherit the same environment. If the user modifies the val- 
ues of these parameters or creates new ones, none of these affects the environment unless the export com- 
mand is used to bind the shell’s parameter to the environment. The environment seen by any executed 
command is thus composed of any unmodified name-value pairs originally inherited by the shell, plus any 
modifications or additions, all of which must be noted in export commands. 


The environment for any simple-command may be augmented by prefixing it with one or more assignments 
to parameters. Thus these two lines are equivalent 


TERM=450 cmd args 
(export TERM; TERM=450; cmd args) 


If the —-k flag is set, all keyword arguments are placed in the environment, even if the occur after the com- 
mand name. The following prints ’a=b c’ and ’c’: 

echo a=b c 

set -—k 

echo a=b c 


Signals. 
The INTERRUPT and QUIT signals for an invoked command are ignored if the command is followed by 
&; otherwise signals have the values inherited by the shell from its parent. (But see also trap.) 


Execution. 
Each time a command is executed the above substitutions are carried out. Except for the special com- 
mands’ listed below a new process is created and an attempt is made to execute the command via an 
execve(2). 


The shell parameter $PATH defines the search path for the directory containing the command. Each alter- 
native directory name is separated by a colon (:). The default path is :/bin:/usr/bin. If the command name 
contains a/, the search path is not used. Otherwise, each directory in the path is searched for an executable 
file. If the file has execute permission but is not an a.out file, it is assumed to be a file containing shell com- 
mands. A subshell (i.e., a separate process) is spawned to read it. A parenthesized command is also exe- 
cuted in a subshell. 


Special commands. 
The following commands are executed in the shell process and except where specified no input output redi- 
rection is permitted for such commands. 


# For non-interactive shells, everything following the # is treated as a comment, i.e. the rest of the 
line is ignored. For interactive shells, the # has no special effect. 


No effect; the command does nothing. 

. file Read and execute commands from file and return. The search path $PATH is used to find the 
directory containing file. 

break [7 | 
Exit from the enclosing for or while loop, if any. If 1 is specified, break 7 levels. 

continue [7 ] 
Resume the next iteration of the enclosing for or while loop. If 7 is specified, resume at the n-th 
enclosing loop. 

cd [arg ] 
Change the current directory to arg. The shell parameter $HOME is the default arg. 

eval [arg ...] 
The arguments are read as input to the shell and the resulting command(s) executed. 

exec [arg ...] 
The command specified by the arguments is executed in place of this shell without creating a new 
process. Input output arguments may appear and if no other arguments are given cause the shell 
input output to be modified. 
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exit [7] Causes a non interactive shell to exit with the exit status specified by n. If n is omitted, the exit sta- 
tus is that of the last command executed. (An end of file will also exit from the shell.) 

export [name ... | 
The given names are marked for automatic export to the environment of subsequently-executed 
commands. If no arguments are given, a list of exportable names is printed. 

login [arg ...] 
Equivalent to ’exec login arg ...’. 

read name ... 
One line is read from the standard input; successive words of the input are assigned to the vari- 
ables name in order, with leftover words to the last variable. The return code is 0 unless the end- 
of-file is encountered. 

readonly [name ... | 
The given names are marked readonly and the values of the these names may not be changed by 
subsequent assignment. If no arguments are given, a list of all readonly names is printed. 

set [-eknptuvx [arg ...]] 


-e If non interactive, exit immediately if a command fails. 

-k All keyword arguments are placed in the environment for a command, not just those that 
precede the command name. 

—n Read commands but do not execute them. 

-t Exit after reading and executing one command. 

-u Treat unset variables as an error when substituting. 

-v Print shell input lines as they are read. 

-x Print commands and their arguments as they are executed. 


- Turn off the —x and —v options. 


These flags can also be used upon invocation of the shell. The current set of flags may be found in 


$-. 


Remaining arguments are positional parameters and are assigned, in order, to $1, $2, etc. If no 
arguments are given, the values of all names are printed. 


shift |The positional parameters from $2... are renamed $1... 
times Print the accumulated user and system times for processes run from the shell. 


trap [arg][n]... 
Arg is a command to be read and executed when the shell receives signal(s) n. (Note that arg is 
scanned once when the trap is set and once when the trap is taken.) Trap commands are executed 
in order of signal number. If arg is absent, all trap(s) n are reset to their original values. If arg is 
the null string, this signal is ignored by the shell and by invoked commands. If n is 0, the com- 
mand arg is executed on exit from the shell, otherwise upon receipt of signal n as numbered in 
sigvec(2). Trap with no arguments prints a list of commands associated with each signal number. 


umask [ nnn | 
The user file creation mask is set to the octal value nnn (see umask(2)). If nnn is omitted, the cur- 
rent value of the mask is printed. 


wait [7 | 
Wait for the specified process and report its termination status. If n is not given, all currently 
active child processes are waited for. The return code from this command is that of the process 
waited for. 


Invocation. 

If the first character of argument zero is -—, commands are read from $HOME/. profile, if such a file exists. 
Commands are then read as described below. The following flags are interpreted by the shell when it is 
invoked. 
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—¢ string If the -c flag is present, commands are read from string . 

-s If the -s flag is present or if no arguments remain then commands are read from the standard 
input. Shell output is written to file descriptor 2. 

-i If the -i flag is present or if the shell input and output are attached to a terminal (as told by 


gtty) then this shell is interactive. In this case the terminate signal SIGTERM (see sigvec(2)) 
is ignored (so that *kill 0’ does not kill an interactive shell) and the interrupt signal SIGINT is 
caught and ignored (so that wait is interruptible). In all cases SIGQUIT is ignored by the 
shell. 


The remaining flags and arguments are described under the set command. 


FILES 

$HOME/. profile 

/tmp/sh* 

/dev/null 
SEE ALSO 

csh(1), test(1), execve(2), environ(7) 
DIAGNOSTICS 


Errors detected by the shell, such as syntax errors cause the shell to return a non zero exit status. If the shell 
is being used non interactively then execution of the shell file is abandoned. Otherwise, the shell returns 
the exit status of the last command executed (see also exit). 


BUGS 
If << is used to provide standard input to an asynchronous process invoked by &, the shell gets mixed up 
about naming the input document. A garbage file /tmp/sh* is created, and the shell complains about not 
being able to find the file by another name. 
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NAME 
size — size of an object file 


SYNOPSIS 
size [ object ... ] 


DESCRIPTION 
Size prints the (decimal) number of bytes required by the text, data, and bss portions, and their sum in hex 
and decimal, of each object-file argument. If no file is specified, a.out is used. 


SEE ALSO 
a.out(5) 
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NAME 
sleep — suspend execution for an interval 
SYNOPSIS 
sleep time 
DESCRIPTION 
Sleep suspends execution for time seconds. It is used to execute a command after a certain amount of time 
as in: 
(sleep 105; command)& 
or to execute a command every so often, as in: 
while true 
do 
command 
sleep 37 
done 
SEE ALSO 
setitimer(2), alarm(3C), sleep(3) 
BUGS 


Time must be less than 2,147,483,647 seconds. 
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NAME 

soelim — eliminate .so’s from nroff input 
SYNOPSIS 

soelim [ file... ] 
DESCRIPTION 


Soelim reads the specified files or the standard input and performs the textual inclusion implied by the nroff 
directives of the form 


.so somefile 


when they appear at the beginning of input lines. This is useful since programs such as tbl do not normally 
do this; it allows the placement of individual tables in separate files to be run as a part of a large document. 


An argument consisting of a single minus (—) is taken to be a file name corresponding to the standard input. 
Note that inclusion can be suppressed by using ‘*” instead of *.’, i.e. 

“so /usr/lib/tmac.s 
A sample usage of soelim would be 

soelim exum?.n | tbl | nroff—ms | col | Ipr 


SEE ALSO 
colcrt(1), more(1) 


BUGS 
The format of the source commands must involve no strangeness — exactly one blank must precede and no 
blanks follow the file name. 
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NAME 
sort — sort or merge files 


SYNOPSIS 
sort [ -mubdfinrtx ] [ +pos/ [-pos2]]... [-o name ] [-T directory ] [name ] ... 


DESCRIPTION 
Sort sorts lines of all the named files together and writes the result on the standard output. The name ‘—’ 
means the standard input. If no input files are named, the standard input is sorted. 


The default sort key is an entire line. Default ordering is lexicographic by bytes in machine collating 
sequence. The ordering is affected globally by the following options, one or more of which may appear. 


b Ignore leading blanks (spaces and tabs) in field comparisons. 

d ‘Dictionary’ order: only letters, digits and blanks are significant in comparisons. 

f Fold upper case letters onto lower case. 

i Ignore characters outside the ASCII range 040-0176 in nonnumeric comparisons. 

n An initial numeric string, consisting of optional blanks, optional minus sign, and zero or more digits 


with optional decimal point, is sorted by arithmetic value. Option n implies option b. 
r Reverse the sense of comparisons. 
tx ‘Tab character’ separating fields is x. 


The notation +pos/ —pos2 restricts a sort key to a field beginning at pos/ and ending just before pos2. 
Posi and pos2 each have the form m.n, optionally followed by one or more of the flags bdfinr, where m 
tells a number of fields to skip from the beginning of the line and n tells a number of characters to skip fur- 
ther. If any flags are present they override all the global ordering options for this key. If the b option is in 
effect n is counted from the first nonblank in the field; b is attached independently to pos2. A missing .n 
means .0; a missing —pos2 means the end of the line. Under the —-tx option, fields are strings separated by x; 
otherwise fields are nonempty nonblank strings separated by blanks. 


When there are multiple sort keys, later keys are compared only after all earlier keys compare equal. Lines 
that otherwise compare equal are ordered with all bytes significant. 


These option arguments are also understood: 


c Check that the input file is sorted according to the ordering rules; give no output unless the file is out 
of sort. 


m Merge only, the input files are already sorted. 


(0) The next argument is the name of an output file to use instead of the standard output. This file may 
be the same as one of the inputs. 


T The next argument is the name of a directory in which temporary files should be made. 


Suppress all but one in each set of equal lines. Ignored bytes and bytes outside keys do not partici- 
pate in this comparison. 


EXAMPLES 
Print in alphabetical order all the unique spellings in a list of words. Capitalized words differ from uncapi- 
talized. 


sort —u +0f +0 list 
Print the password file (passwd (5)) sorted by user id number (the 3rd colon-separated field). 


sort —t: +2n /etc/passwd 


7th Edition April 29, 1985 1 


SORT (1) UNIX Programmer’s Manual SORT (1) 


Print the first instance of each month in an already sorted file of (month day) entries. The options -um with 
just one input file make the choice of a unique representative from a set of equal lines predictable. 


sort —um +0 —1 dates 


FILES 
/usr/tmp/stm*, /tmp/* first and second tries for temporary files 
SEE ALSO 
uniq(1), comm(1), rev(1), join(1) 
DIAGNOSTICS 
Comments and exits with nonzero status for various trouble conditions and for disorder discovered under 
option —c. 
BUGS 


Very long lines are silently truncated. 
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NAME 


sortbib — sort bibliographic database 


SYNOPSIS 


sortbib [ -sKEYS | database ... 


DESCRIPTION 


Sortbib sorts files of records containing refer key-letters by user-specified keys. Records may be separated 
by blank lines, or by .[ and .] delimiters, but the two styles may not be mixed together. This program reads 
through each database and pulls out key fields, which are sorted separately. The sorted key fields contain 
the file pointer, byte offset, and length of corresponding records. These records are delivered using disk 
seeks and reads, so sortbib may not be used in a pipeline to read standard input. 


By default, sortbib alphabetizes by the first %A and the %D fields, which contain the senior author and 
date. The -s option is used to specify new KEYS. For instance, -sATD will sort by author, title, and date, 
while -sA+D will sort by all authors, and date. Sort keys past the fourth are not meaningful. No more than 
16 databases may be sorted together at one time. Records longer than 4096 characters will be truncated. 


Sortbib sorts on the last word on the %A line, which is assumed to be the author’s last name. A word in the 
final position, such as “‘jr.’’ or ‘‘ed.’’, will be ignored if the name beforehand ends with a comma. Authors 
with two-word last names or unusual constructions can be sorted correctly by using the nroff convention 
“\0’’ in place of a blank. A %Q field is considered to be the same as %A, except sorting begins with the 
first, not the last, word. Sortbib sorts on the last word of the %D line, usually the year. It also ignores lead- 
ing articles (like “‘A’’ or “‘The’’) when sorting by titles in the %T or %J fields; it will ignore articles of any 
modern European language. If a sort-significant field is absent from a record, sortbib places that record 
before other records containing that field. 


SEE ALSO 


refer(1), addbib(1), roffbib(1), indxbib(1), lookbib(1) 


AUTHORS 


BUGS 


Greg Shenaut, Bill Tuthill 


Records with missing author fields should probably be sorted by title. 
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NAME 


spell, spellin, spellout — find spelling errors 


SYNOPSIS 


spell [ —v ] [ -b ] [ -x ] [-d hlist ] [-s hstop ] [ -h spellhist ] [ file ] ... 
spellin [ list ] 
spellout [ -d ] list 


DESCRIPTION 


Spell collects words from the named documents, and looks them up in a spelling list. Words that neither 
occur among nor are derivable (by applying certain inflections, prefixes or suffixes) from words in the spel- 
ling list are printed on the standard output. If no files are named, words are collected from the standard 
input. 


Spell ignores most troff, tbl and eqn(1) constructions. 


Under the -v option, all words not literally in the spelling list are printed, and plausible derivations from 
spelling list words are indicated. 


Under the —b option, British spelling is checked. Besides preferring centre, colour, speciality, travelled, 
etc., this option insists upon -ise in words like standardise, Fowler and the OED to the contrary notwith- 
standing. 


Under the —x option, every plausible stem is printed with ‘=’ for each word. 


The spelling list is based on many sources. While it is more haphazard than an ordinary dictionary, it is 
also more effective with proper names and popular technical words. Coverage of the specialized vocabular- 
ies of biology, medicine and chemistry is light. 


The auxiliary files used for the spelling list, stop list, and history file may be specified by arguments follow- 
ing the -d, -s, and -h options. The default files are indicated below. Copies of all output may be accumu- 
lated in the history file. The stop list filters out misspellings (e.g. thier=thy—y+ier) that would otherwise 
pass. 


Two routines help maintain the hash lists used by spell. Both expect a set of words, one per line, from the 
standard input. Spellin combines the words from the standard input and the preexisting Jist file and places a 
new list on the standard output. If no list file is specified, the new list is created from scratch. Spellout 
looks up each word from the standard input and prints on the standard output those that are missing from 
(or present on, with option -d) the hashed Jist file. For example, to verify that hookey is not on the default 
spelling list, add it to your own private list, and then use it with spell, 


echo hookey | spellout /usr/dict/hlista 
echo hookey | spellin /usr/dict/hlista > myhlist 
spell —d myhlist huckfinn 


FILES 
/usr/dict/hlist[ab] hashed spelling lists, American & British, default for -d 
/usr/dict/hstop hashed stop list, default for -s 
/dev/null history file, default for -h 
/tmp/spell.$$* temporary files 
/usr/lib/spell 
SEE ALSO 


BUGS 


deroff(1), sort(1), tee(1), sed(1) 


The spelling list’s coverage is uneven; new installations will probably wish to monitor the output for sev- 
eral months to gather local additions. 
Rritish spelling was done by an American. 
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spline — interpolate smooth curve 


SYNOPSIS 


spline [ option ] ... 

DESCRIPTION 
Spline takes pairs of numbers from the standard input as abcissas and ordinates of a function. It produces a 
similar set, which is approximately equally spaced and includes the input set, on the standard output. The 
cubic spline output (R. W. Hamming, Numerical Methods for Scientists and Engineers, 2nd ed., 349ff) has 
two continuous derivatives, and sufficiently many points to look smooth when plotted, for example by 
graph(1G). 


The following options are recognized, each as a separate argument. 


-—a 


-k 


—n 


—p 


-x 


SEE ALSO 


Supply abscissas automatically (they are missing from the input); spacing is given by the next argu- 
ment, or is assumed to be | if next argument is not a number. 


The constant k used in the boundary value computation 


yO = kyf, Yn = kyn-1 


is set by the next argument. By default k = 0. 


Space output points so that approximately n intervals occur between the lower and upper x limits. 
(Default n = 100.) 


Make output periodic, i.e. match derivatives at ends. First and last input values should normally 
agree. 


Next | (or 2) arguments are lower (and upper) x limits. Normally these limits are calculated from the 
data. Automatic abcissas start at lower limit (default 0). 


graph(1G), plot(1G) 


DIAGNOSTICS 
When data is not strictly monotone in x, spline reproduces the input without interpolating extra points. 


BUGS 


A limit of 1000 input points is enforced silently. 
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NAME 

split — split a file into pieces 
SYNOPSIS 

split [ -7 ] [ file [ name ] ] 


DESCRIPTION 
Split reads file and writes it in n-line pieces (default 1000), as many as necessary, onto a set of output files. 
The name of the first output file is name with aa appended, and so on lexicographically. If no output name 
is given, x is default. 


If no input file is given, or if — is given in its stead, then the standard input file is used. 
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NAME 

strings — find the printable strings in a object, or other binary, file 
SYNOPSIS 

strings [ - ] [-o ] [ -number | file ... 
DESCRIPTION 


Strings looks for ascii strings in a binary file. A string is any sequence of 4 or more printing characters end- 
ing with a newline or a null. Unless the — flag is given, strings only looks in the initialized data space of 
object files. If the -o flag is given, then each string is preceded by its offset in the file (in octal). If the 
-number flag is given then number is used as the minimum string length rather than 4. 


Strings is useful for identifying random object files and many other things. 


SEE ALSO 
od(1) 


BUGS 
The algorithm for identifying strings is extremely primitive. 
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NAME 
strip — remove symbols and relocation bits 


SYNOPSIS 
strip name ... 


DESCRIPTION 
Strip removes the symbol table and relocation bits ordinarily attached to the output of the assembler and 
loader. This is useful to save space after a program has been debugged. 


The effect of strip is the same as use of the -s option of Id. 


FILES 

/tmp/stm? temporary file 
SEE ALSO 

Id(1) 
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struct — structure Fortran programs 


SYNOPSIS 


struct [ option ] ... file 


DESCRIPTION 


Struct translates the Fortran program specified by file (standard input default) into a Ratfor program. Wher- 
ever possible, Ratfor control constructs replace the original Fortran. Statement numbers appear only where 
still necessary. Cosmetic changes are made, including changing Hollerith strings into quoted strings and 
relational operators into symbols (.e.g. '".GT." into ">"). The output is appropriately indented. 


The following options may occur in any order. 


-s Input is accepted in standard format, i.e. comments are specified by ac, C, or * in column 1, and 
continuation lines are specified by a nonzero, nonblank character in column 6. Normally input is 
in the form accepted by f77(1) 

-i Do not turn computed goto statements into switches. (Ratfor does not turn switches back into 
computed goto statements.) 

-a Turn sequences of else ifs into a non-Ratfor switch of the form 
switch 

{ case pred1: code 
case pred2: code 
case pred3: code 
default: code 
} 
The case predicates are tested in order; the code appropriate to only one case is executed. This 
generalized form of switch statement does not occur in Ratfor. 

-b Generate goto’s instead of multilevel break statements. 

—n Generate goto’s instead of multilevel next statements. 

-tn Make the nonzero integer n the lowest valued label in the output program (default 10). 

-cn Increment successive labels in the output program by the nonzero integer n (default 1). 

-en If n is 0 (default), place code within a loop only if it can lead to an iteration of the loop. If n is 
nonzero, admit a small code segments to a loop if otherwise the loop would have exits to several 
places including the segment, and the segment can be reached only from the loop. ‘Small’ is close 
to, but not equal to, the number of statements in the code segment. Values of n under 10 are sug- 
gested. 

FILES 
/tmp/struct* 
/usr/lib/struct/* 
SEE ALSO 
£77(1) 
BUGS 


Struct knows Fortran 66 syntax, but not full Fortran 77. 

If an input Fortran program contains identifiers which are reserved words in Ratfor, the structured version 
of the program will not be a valid Ratfor program. 

The labels generated cannot go above 32767. 

If you get a goto without a target, try -e. 


7th Edition 


April 29, 1985 1 


STTY (1) UNIX Programmer’s Manual STTY (1) 


NAME 

stty — set terminal options 
SYNOPSIS 

stty [ option ... ] 
DESCRIPTION 


Stty sets certain I/O options on the current output terminal, placing its output on the diagnostic output. 
With no argument, it reports the speed of the terminal and the settings of the options which are different 
from their defaults. Use of one of the following options modifies the output as described: 


all All normally used option settings are reported. 
everything Everything stty knows about is printed. 
speed The terminal speed alone is printed on the standard output. 


size The terminal (window) sizes are printed on the standard output, first rows and then columns. 


The option strings are selected from the following set: 


even allow even parity input 

-even disallow even parity input 

odd allow odd parity input 

-—odd disallow odd parity input 

raw raw mode input (no input processing (erase, kill, interrupt, ...); parity bit passed back) 

-raw negate raw mode 

cooked same as ‘raw’ 

cbreak make each character available to read(2) as received; no erase and kill processing, but all other 


processing (interrupt, suspend, ...) is performed 
-cbreak = make characters available to read only when newline is received 


—nl allow carriage return for new-line, and output CR-LF for carriage return or new-line 
nl accept only new-line to end lines 

echo echo back every character typed 

-echo do not echo characters 

Icase map upper case to lower case 

—Icase do not map case 


tandem enable flow control, so that the system sends out the stop character when its internal queue is in 
danger of overflowing on input, and sends the start character when it is ready to accept further 


input 
-tandem = disable flow control 
—tabs replace tabs by spaces when printing 
tabs preserve tabs 
ek set erase and kill characters to # and @ 


665599 


For the following commands which take a character argument c, you may also specify c as the ‘“‘u’’ or 
“‘undef”’, to set the value to be undefined. A value of ‘**x’’, a 2 character sequence, is also interpreted as a 


control character, with ‘‘*?’’ representing delete. 

erase c set erase character to c (default ‘#’, but often reset to “H.) 

kill c set kill character to c (default ‘@’, but often reset to “U.) 

intr c set interrupt character to c (default DEL or *? (delete), but often reset to *C.) 

quit c set quit character to c (default control \.) 

start c set start character to c (default control Q.) 

stop c set stop character to c (default control S.) 

eof c set end of file character to c (default control D.) 

brk c set break character to c (default undefined.) This character is an additional character causing 


wakeup. 
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cr0 cri cr2 cr3 


select style of delay for carriage return (see ioctl(2)) 


nl0 nl nl2 ni3 


select style of delay for linefeed 


tab0 tab1 tab2 tab3 


ff0 ff1 
bs0 bs1 


tty33 
tty37 
vt05 
dec 


tn300 
ti700 
tek 

0 


select style of delay for tab 
select style of delay for form feed 
select style of delay for backspace 


set all modes suitable for the Teletype Corporation Model 33 terminal. 

set all modes suitable for the Teletype Corporation Model 37 terminal. 

set all modes suitable for Digital Equipment Corp. VTO5 terminal 

set all modes suitable for Digital Equipment Corp. operating systems users; (erase, kill, and 
interrupt characters to ~?, “U, and “C, decctlq and “‘newcrt’’.) 


set all modes suitable for a General Electric TermiNet 300 

set all modes suitable for Texas Instruments 700 series terminal 
set all modes suitable for Tektronix 4014 terminal 

hang up phone line immediately 


50 75 110 134 150 200 300 600 1200 1800 2400 4800 9600 exta extb 


rows n 


Set terminal baud rate to the number given, if possible. (These are the speeds supported by the 
DH-11 interface). 


The terminal size is recorded as having n rows. 


columns n The terminal size is recorded as having n columns. 


cols n 


is an alias for columns. 


A teletype driver which supports the job control processing of csh(1) and more functionality than the basic 
driver is fully described in tty(4). The following options apply only to it. 


new 
crt 

crtbs 
prterase 
crterase 
—crterase 
ertkill 
—crtkill 
ctlecho 


—ctlecho 


decctlq 


—decctlq 


tostop 
—tostop 
tilde 
tilde 
flusho 
-flusho 
pendin 


Use new driver (switching flushes typeahead). 

Set options for a CRT (crtbs, ctlecho and, if >= 1200 baud, crterase and crtkill.) 
Echo backspaces on erase characters. 

For printing terminal echo erased characters backwards within ‘‘\’’ and ‘‘/’’. 
Wipe out erased characters with ‘‘backspace-space-backspace.’’ 

Leave erased characters visible; just backspace. 

Wipe out input on like kill ala crterase. 

Just echo line kill character and a newline on line kill. 
Echo control characters as ‘‘*x’’ (and delete as ‘“*?’’ 
EOT character (control D). 

Control characters echo as themselves; in cooked mode EOT (control-D) is not echoed. 


.) Print two backspaces following the 


After output is suspended (normally by *S), only a start character (normally *Q) will restart it. 
This is compatible with DEC’s vendor supplied systems. 


After output is suspended, any character typed will restart it; the start character will restart out- 
put without providing any input. (This is the default.) 

Background jobs stop if they attempt terminal output. 

Output from background jobs to the terminal is allowed. 

Convert to ‘*’’ on output (for Hazeltine terminals). 

Leave poor “*”’ alone. 

Output is being discarded usually because user hit control O (internal state bit). 

Output is not being discarded. 

Input is pending after a switch from cbreak to cooked and will be re-input when a read 
becomes pending or more input arrives (internal state bit). 


oon? 
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-pendin _ Input is not pending. 

pass8 Passes all 8 bits through on input, in any mode. 

—pass8 Strips the 0200 bit on input except in raw mode. 

mdmbuf — Start/stop output on carrier transitions (not implemented). 
-mdmbuf Return error if write attempted after carrier drops. 

litout Send output characters without any processing. 

—litout Do normal output processing, inserting delays, etc. 

nohang Don’t send hangup signal if carrier drops. 

-—nohang — Send hangup signal to control process group when carrier drops. 
etxack Diablo style etx/ack handshaking (not implemented). 


The following special characters are applicable only to the new teletype driver and are not normally 


changed. 
susp c set suspend process character to c (default control Z). 
dsusp c set delayed suspend process character to c (default control Y). 
rprntc set reprint line character to c (default control R). 
flush c set flush output character to c (default control O). 
werasec _ set word erase character to c (default control W). 
Inext c set literal next character to c (default control V). 
SEE ALSO 


ioctl(2), tabs(1), tset(1), tty(4) 
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NAME 
style — analyze surface characteristics of a document 


SYNOPSIS 
style [-ml ] [-mm ] [-a][-e] [-lnum][-rnum][-p][-P] file... 


DESCRIPTION 
Style analyzes the surface characteristics of the writing style of a document. It reports on readability, sen- 
tence length and structure, word length and usage, verb type, and sentence openers. Because style runs der- 
off before looking at the text, formatting header files should be included as part of the input. The default 
macro package —ms may be overridden with the flag -mm. The flag -ml, which causes deroff to skip lists, 
should be used if the document contains many lists of non-sentences. The other options are used to locate 
sentences with certain characteristics. 


-a print all sentences with their length and readability index. 
-e print all sentences that begin with an expletive. 
-p print all sentences that contain a passive verb. 


—Inum print all sentences longer than num. 
-rmum print all sentences whose readability index is greater than num. 
—-P print parts of speech of the words in the document. 


SEE ALSO 
deroff(1), diction(1) 


BUGS 
Use of non-standard formatting macros may cause incorrect sentence breaks. 
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NAME 

su — substitute user id temporarily 
SYNOPSIS 

su [ -f ] [—] [ userid ] 
DESCRIPTION 


Su demands the password of the specified userid, and if it is given, changes to that userid and invokes the 
Shell sh(1) or csh(1) without changing the current directory. The user environment is unchanged except 
for HOME and SHELL, which are taken from the password file for the user being substituted (see envi- 
ron(7)). The new user ID stays in force until the Shell exits. 


If no userid is specified, ‘‘root’’ is assumed. Only users in the ‘‘wheel’’ group (group 0) can su to “‘root’’, 
even with the root password. To remind the super-user of his responsibilities, the Shell substitutes “#’ for 
its usual prompt. 


The -f option prevents csh(1) from executing the .cshrc file; thus making su start up faster. 
The — option simulates a full login. 


SEE ALSO 
sh(1), esh(1) 
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NAME 
sum — sum and count blocks in a file 


SYNOPSIS 
sum file 


DESCRIPTION 
Sum calculates and prints a 16-bit checksum for the named file, and also prints the number of blocks in the 
file. It is typically used to look for bad spots, or to validate a file communicated over some transmission 
line. 


SEE ALSO 
we(1) 


DIAGNOSTICS 
‘Read error’ is indistinguishable from end of file on most devices; check the block count. 
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NAME 
symorder — rearrange name list 


SYNOPSIS 
symorder orderlist symbolfile 


DESCRIPTION 
Orderlist is a file containing symbols to be found in symbolfile, 1 symbol per line. 


Symbolfile is updated in place to put the requested symbols first in the symbol table, in the order specified. 
This is done by swapping the old symbols in the required spots with the new ones. If all of the order sym- 
bols are not found, an error is generated. 


This program was specifically designed to cut down on the overhead of getting symbols from /vmunix. 


SEE ALSO 
nlist(3) 
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NAME 


sysline — display system status on status line of a terminal 


SYNOPSIS 


sysline [ —bcdewhDilmpqrsj | [ -H remote ] [ +N ] 


DESCRIPTION 


Sysline runs in the background and periodically displays system status information on the status line of the 
terminal. Not all terminals contain a status line. Those that do include the h19, concept 108, Ann Arbor 
Ambassador, vt100, Televideo 925/950 and Freedom 100. If no flags are given, sysline displays the time of 
day, the current load average, the change in load average in the last 5 minutes, the number of users (fol- 
lowed by a ‘u’), the number of runnable process (followed by a ‘r’)[VAX only], the number of suspended 
processes (followed by a ‘s’)[VAX only], and the users who have logged on and off since the last status 
report. Finally, if new mail has arrived, a summary of it is printed. If there is unread mail in your mailbox, 
an asterisk will appear after the display of the number of users. The display is normally in reverse video (if 
your terminal supports this in the status line) and is right justified to reduce distraction. Every fifth display 
is done in normal video to give the screen a chance to rest. 


If you have a file named .who in your home directory, then the contents of that file is printed first. One 
common use of this feature is to alias chdir, pushd, and popd to place the current directory stack in ~/.who 
after it changes the new directory. 


The following flags may be given on the command line. 


-b Beep once every half hour and twice every hour, just like those obnoxious watches you keep 
hearing. 

—C Clear the status line for 5 seconds before each redisplay. 

-d Debug mode -- print status line data in human readable format. 

-D Print out the current day/date before the time. 

-e Print out only the information. Do not print out the control commands necessary to put the 


information on the bottom line. This option is useful for putting the output of sysline onto 
the mode line of an emacs window. 


-w Window mode -- print the status on the current line of the terminal, suitable for use inside a 
one line window. 


-Hremote Print the load average on the remote host remote [VAX only]. If the host is down, or is not 
sending out rwhod packets, then the down time is printed instead. If the prefix "ucb" is pre- 
sent, then it is removed. 


-h Print out the host machine’s name after the time [VAX only]. 

-l Don’t print the names of people who log in and out. 

—m Don’t check for mail. 

-p Don’t report the number of process which are runnable and suspended. 

-r Don’t display in reverse video. 

+N Update the status line every N seconds. The default is 60 seconds. 

-q Don’t print out diagnostic messages if something goes wrong when starting up. 

-i Print out the process id of the sysline process onto standard output upon startup. With this 


information you can send the alarm signal to the sysline process to cause it to update imme- 
diately. sysline writes to the standard error, so you can redirect the standard output into a file 
to catch the process id. 
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-Ss Print "short" form of line by left-justifying iff escapes are not allowed in the status line. 
Some terminals (the Televideos and Freedom 100 for example) do not allow cursor move- 
ment (or other "intelligent" operations) in the status line. For these terminals, sysline nor- 
mally uses blanks to cause right-justification. This flag will disable the adding of the blanks. 


-j Force the sysline output to be left justified even on terminals capable of cursor movement on 
the status line. 


If you have a file .syslinelock in your home directory, then sysline will not update its statistics and write on 
your screen, it will just go to sleep for a minute. This is useful if you want to momentarily disable sysline. 
Note that it may take a few seconds from the time the lock file is created until you are guaranteed that sys- 
line will not write on the screen. 


FILES 
/etc/utmp names of people who are logged in 
/dev/kmem contains process table [VAX only] 
/usr/spool/rwho/whod.* who/uptime information for remote hosts [VAX only] 
${HOME}/.who information to print on bottom line 
${ HOME}/.syslinelock when it exists, sysline will not print 
AUTHORS 
John Foderaro 
Tom Ferrin converted it to use termcap. 
Mark Horton added terminfo capability. 
BUGS 


If you interrupt the display then you may find your cursor missing or stuck on the status line. The best 
thing to do is reset the terminal. 
If there is too much for one line, the excess is thrown away. 
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NAME 

systat — display system statistics on a crt 
SYNOPSIS 

systat [ —display | [ refresh-interval | 
DESCRIPTION 


Systat displays various system statistics in a screen oriented fashion using the curses screen display library, 
curses(3X). 


While systat is running the screen is usually divided into two windows (an exception is the vmstat display 
which uses the entire screen). The upper window depicts the current system load average. The information 
displayed in the lower window may vary, depending on user commands. The last line on the screen is 
reserved for user input and error messages. 


By default systat displays the processes getting the largest percentage of the processor in the lower window. 
Other displays show swap space usage, disk i/o statistics (a la iostat(1)), virtual memory statistics (a la 
vmstat(1)), network ‘‘mbuf’’ utilization, and network connections (a la netstat(1)). 


Input is interpreted at two different levels. A ‘‘global’’ command interpreter processes all keyboard input. 
If this command interpreter fails to recognize a command, the input line is passed to a per-display com- 
mand interpreter. This allows each display to have certain display-specific commands. 


Certain characters cause immediate action by systat. These are 


“L Refresh the screen. 
°“G Print the name of the current “‘display’’ being shown in the lower window and the refresh interval. 
°Z Stop systat. 


Move the cursor to the command line and interpret the input line typed as a command. While 
entering a command the current character erase, word erase, and line kill characters may be used. 


The following commands are interpreted by the ‘‘global’’ command interpreter. 


help 

Print the names of the available displays on the command line. 
load 

Print the load average over the past 1, 5, and 15 minutes on the command line. 
stop 


Stop refreshing the screen. 


[ start ] [ number | 
Start (continue) refreshing the screen. If a second, numeric, argument is provided it is interpreted 
as a refresh interval (in seconds). Supplying only a number will set the refresh interval to this 
value. 

quit 
Exit systat. (This may be abbreviated to q.) 

The available displays are: 


pigs 
Display, in the lower window, those processes resident in main memory and getting the largest 
portion of the processor (the default display). When less than 100% of the processor is scheduled 
to user processes, the remaining time is accounted to the ‘“‘idle’’ process. 

iostat 


Display, in the lower window, statistics about processor use and disk throughput. Statistics on 
processor use appear as bar graphs of the amount of time executing in user mode (‘“‘user’’), in user 
mode running low priority processes (‘‘nice’’), in system mode (“‘system’’), and idle (‘‘idle’’). 
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Statistics on disk throughput show, for each drive, kilobytes of data transferred, number of disk 
transactions performed, and average seek time (in milliseconds). This information may be dis- 
played as bar graphs or as rows of numbers which scroll downward. Bar graphs are shown by 
default; commands specific to this display are discussed below. 


swap 
Display, in the lower window, swap space in use on each swap device configured. Two sets of bar 
graphs are shown. The upper graph displays swap space allocated to pure text segments (code), 
the lower graph displays space allocated to stack and data segments. Allocated space is sorted by 
its size into buckets of size dmmin, dmmin*2, dmmin*4, up to dmmax (to reflect allocation poli- 
cies imposed by the system). The disk segment size, in sectors, is displayed along the left hand 
side of the text, and data and stack graphs. Space allocated to the user structure and page tables is 
not currently accounted for. 


mbufs 
Display, in the lower window, the number of mbufs allocated for particular uses, i.e. data, socket 
structures, etc. 


vmstat 
Take over the entire display and show a (rather crowded) compendium of statistics related to vir- 
tual memory usage, process scheduling, device interrupts, system name translation cacheing, disk 
i/o, etc. 


The upper left quadrant of the screen shows the number of users logged in and the load average 
over the last one, five, and fifteen minute intervals. Below this line are statistics on memory uti- 
lization. The first row of the table reports memory usage only among active processes, that is pro- 
cesses that have run in the previous twenty seconds. The second row reports on memory usage of 
all processes. The first column reports on the number of physical pages claimed by processes. 
The second column reports the number of physical pages that are devoted to read only text pages. 
The third and fourth columns report the same two figures for virtual pages, that is the number of 
pages that would be needed if all processes had all of their pages. Finally the last column shows 
the number of physical pages on the free list. 


Below the memory display is the disk usage display. It reports the number of seeks, transfers, and 
number of kilobyte blocks transferred per second averaged over the refresh period of the display 
(by default, five seconds). For some disks it also reports the average milliseconds per seek. Note 
that the system only keeps statistics on at most four disks. 


Below the disk display is a list of the average number of processes (over the last refresh interval) 
that are runnable (‘r’), in page wait (‘p’), in disk wait other than paging (‘d’), sleeping (‘s’), and 
swapped out but desiring to run (‘w’). Below the queue length listing is a numerical listing and a 
bar graph showing the amount of system (shown as ‘=’), user (shown as ‘>’), nice (shown as ‘-’), 
and idle time (shown as ‘ ’). 


At the bottom left are statistics on name translations. It lists the number of names translated in the 
previous interval, the number and percentage of the translations that were handled by the system 
wide name translation cache, and the number and percentage of the translations that were handled 
by the per process name translation cache. 


Under the date in the upper right hand quadrant are statistics on paging and swapping activity. 
The first two columns report the average number of pages brought in and out per second over the 
last refresh interval due to page faults and the paging daemon. The third and fourth columns 
report the average number of pages brought in and out per second over the last refresh interval due 
to swap requests initiated by the scheduler. The first row of the display shows the average number 
of disk transfers per second over the last refresh interval; the second row of the display shows the 
average number of pages transferred per second over the last refresh interval. 
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Below the paging statistics is a line listing the average number of total reclaims (’Rec’), intransit 
blocking page faults (‘It’), swap text pages found in free list (“F/S’), file system text pages found 
in free list (‘F/F’), reclaims from free list (“RFL’), pages freed by the clock daemon (‘Fre’), and 
sequential process pages freed (‘SFr’) per second over the refresh interval. 


Below this line are statistics on the average number of zero filled pages (‘zf?) and demand filled 
text pages (‘xf’) per second over the refresh period. The first row indicates the number of requests 
that were resolved, the second row shows the number that were set up, and the last row shows the 
percentage of setup requests were actually used. Note that this percentage is usually less than 
100%, however it may exceed 100% if a large number of requests are actually used long after they 
were set up during a period when no new pages are being set up. Thus this figure is most interest- 
ing when observed over a long time period, such as from boot time (see below on getting such a 
display). 


Below the page fill statistics is a column that lists the average number of context switches (‘Csw’), 
traps (‘Trp’), system calls (‘Sys’), interrupts (‘Int’), characters output to DZ ports using pseudo- 
DMA (‘Pdm’), page faults (‘Flt’), pages scanned by the page daemon (‘Scn’), and revolutions of 
the page daemon’s hand (‘Rev’) per second over the refresh interval. 


Running down the right hand side of the display is a breakdown of the interrupts being handled by 
the system. At the top of the list is the total interrupts per second over the time interval. The rest 
of the column breaks down the total on a device by device basis. Only devices that have inter- 
rupted at least once since boot time are shown. 


netstat 
Display, in the lower window, network connections. By default, network servers awaiting 
requests are not displayed. Each address is displayed in the format “‘host.port’’, with each shown 
symbolically, when possible. It is possible to have addresses displayed numerically, limit the dis- 
play to a set of ports, hosts, and/or protocols; see the list of commands below. 


Commands to switch between displays may be abbreviated to the minimum unambiguous prefix; for exam- 
ple, ‘‘io’’ for ‘‘iostat’’. Certain information may be discarded when the screen size is insufficient for dis- 
play. For example, on a machine with 10 drives the iostat bar graph displays only 3 drives on a 24 line ter- 
minal. When a bar graph would overflow the allotted screen space it is truncated and the actual value is 
printed ‘‘over top’’ of the bar. 


The following commands are specific to the iostat display; the minimum unambiguous prefix may be sup- 
plied. 


numbers 
Show the disk i/o statistics in numeric form. Values are displayed in numeric columns which 
scroll downward. 


bars Show the disk i/o statistics in bar graph form (default). 
msps Toggle the display of average seek time (the default is to not display seek times). 


The following commands are specific to the vmstat display; the minimum unambiguous prefix may be sup- 
plied. 


boot Display cumulative statistics since the system was booted. 

run Display statistics as a running total from the point this command is given. 
time Display statistics averaged over the refresh interval (the default). 

Zero Reset running statistics to zero. 


The following commands are common to each display which shows information about disk drives. These 
commands are used to select a set of drives to report on, should your system have more drives configured 
than can normally be displayed on the screen. 
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FILES 


ignore [ drives ] 
Do not display information about the drives indicated. Multiple drives may be specified, separated 
by spaces. 


display [ drives ] 
Display information about the drives indicated. Multiple drives may be specified, separated by 
spaces. 


The following command is specific to the netstat display; the minimum unambiguous prefix may be sup- 
plied. 


all Toggle the displaying of server processes awaiting requests (this is the equivalent of the —a flag to 
netstat(1)). 


numbers 
Display network addresses numerically. 


names Display network addresses symbolically. 


The remaining commands are common to displays which report network connections (currently only the 
netstat display). These commands may be used to select a specific set of connections for systat to report 
on. 


protocol 
Display only network connections using the indicated protocol (currently either ‘‘tcp’’ or “‘udp’’). 


ignore [items] 
Do not display information about connections associated with the specified hosts or ports. Hosts 
and ports may be specified by name (“‘ucbmonet’’, “‘ftp’’), or numerically. Host addresses use the 
Internet dot notation (‘*128.32.0.9’’). Multiple items may be specified with a single command by 
separating them with spaces. 


display [items] 
Display information about the connections associated with the specified hosts or ports. As for 
ignore, items may be names or numbers. 


show [ports | hosts] 
Show, on the command line, the currently selected protocols, hosts, and ports. Hosts and ports 
which are being ignored are prefixed with a ‘!’. If ports or hosts is supplied as an argument to 
show, then only the requested information will be displayed. 


reset _—_ Reset the port, host, and protocol matching mechanisms to the default (any protocol, port, or host). 


/vmunix for the namelist 

/dev/kmem __ for information in main memory 

/dev/drum for information about swapped out processes 
/etc/hosts for host names 

/etc/networks for network names 

/etc/services for port names 


AUTHOR 


BUGS 


The unknown hacker. The pigs display is derived from a program of the same name written by Bill Reeves. 


Takes 2-10 percent of the cpu. Certain displays presume a 24 line by 80 character terminal. The swap 
space display should account for space allocated to the user structure and page tables. The vmstat display 
looks out of place because it is (it was added in as a separate display rather than create a new program). 


The whole thing is pretty hokey and was included in the distribution under serious duress. 
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NAME 
tabs — set terminal tabs 


SYNOPSIS 
tabs [ —n J [ terminal ] 


DESCRIPTION 
Tabs sets the tabs on a variety of terminals. Various terminal names given in term(7) are recognized; the 
default is, however, suitable for most 300 baud terminals. If the —n flag is present then the left margin is 
not indented as is normal. 


SEE ALSO 
stty(1), term(7) 


BUGS 
It’s much better to use tset(1). 
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NAME 
tail — deliver the last part of a file 


SYNOPSIS 
tail [ tnumber[Ibc] [fr] ] [ file ] 

DESCRIPTION 
Tail copies the named file to the standard output beginning at a designated place. If no file is named, the 
standard input is used. 


Copying begins at distance +number from the beginning, or —number from the end of the input. Number is 
counted in units of lines, blocks or characters, according to the appended option I, b or c. When no units are 
specified, counting is by lines. 


Specifying r causes tail to print lines from the end of the file in reverse order. The default for r is to print 
the entire file this way. Specifying f causes tail to not quit at end of file, but rather wait and try to read 
repeatedly in hopes that the file will grow. 


SEE ALSO 
dd(1) 


BUGS 
Tails relative to the end of the file are treasured up in a buffer, and thus are limited in length. 


Various kinds of anomalous behavior may happen with character special files. 
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NAME 
talk — talk to another user 
SYNOPSIS 
talk person [ ttyname ] 
DESCRIPTION 
Talk is a visual communication program which copies lines from your terminal to that of another user. 
If you wish to talk to someone on you own machine, then person is just the person’s login name. If you 
wish to talk to a user on another host, then person is of the form : 
host!user or 
host.user or 
host:user or 
user@ host 
though host@ user is perhaps preferred. 
If you want to talk to a user who is logged in more than once, the ttyname argument may be used to indicate 
the appropriate terminal name. 
When first called, it sends the message 
Message from TalkDaemon@his_ machine... 
talk: connection requested by your_name@your_machine. 
talk: respond with: talk your_name@your_machine 
to the user you wish to talk to. At this point, the recipient of the message should reply by typing 
talk your_name@your_machine 
It doesn’t matter from which machine the recipient replies, as long as his login-name is the same. Once 
communication is established, the two parties may type simultaneously, with their output appearing in sepa- 
rate windows. Typing control L will cause the screen to be reprinted, while your erase, kill, and word kill 
characters will work in talk as normal. To exit, just type your interrupt character; talk then moves the cur- 
sor to the bottom of the screen and restores the terminal. 
Permission to talk may be denied or granted by use of the mesg command. At the outset talking is allowed. 
Certain commands, in particular nroff and pr(1) disallow messages in order to prevent messy output. 
FILES 
/etc/hosts to find the recipient’s machine 
/etc/utmp to find the recipient’s tty 
SEE ALSO 
mesg(1), who(1), mail(1), write(1) 
BUGS 


The version of talk(1) released with 4.3BSD uses a protocol that is incompatible with the protocol used in 
the version released with 4.2BSD. 
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tar — tape archiver 


SYNOPSIS 


tar [ key ] [name ... ] 


DESCRIPTION 


Tar saves and restores multiple files on a single file (usually a magnetic tape, but it can be any file). Tar’s 
actions are controlled by the key argument. The key is a string of characters containing at most one function 
letter and possibly one or more function modifiers. Other arguments to far are file or directory names spec- 
ifying which files to dump or restore. In all cases, appearance of a directory name refers to the files and 
(recursively) subdirectories of that directory. 


The function portion of the key is specified by one of the following letters: 


r 


x 


The named files are written on the end of the tape. The c function implies this. 


The named files are extracted from the tape. If the named file matches a directory whose contents 
had been written onto the tape, this directory is (recursively) extracted. The owner, modification 
time, and mode are restored (if possible). If no file argument is given, the entire content of the 
tape is extracted. Note that if multiple entries specifying the same file are on the tape, the last one 
overwrites all earlier. 


The names of the specified files are listed each time they occur on the tape. If no file argument is 
given, all of the names on the tape are listed. 


The named files are added to the tape if either they are not already there or have been modified 
since last put on the tape. 


Create a new tape; writing begins on the beginning of the tape instead of after the last file. This 
command implies r. 


The following characters may be used in addition to the letter which selects the function desired. 


oO 


7th Edition 


On output, tar normally places information specifying owner and modes of directories in the 
archive. Former versions of tar, when encountering this information will give error message of 
the form 

"<name>/: cannot create". 
This modifier will suppress the directory information. 


This modifier says to restore files to their original modes, ignoring the present uwmask(2). 
Setuid and sticky information will also be restored to the super-user. 


This modifier selects an alternate drive on which the tape is mounted. The default is drive 0 at 
1600 bpi, which is normally /dev/rmt8. 


Normally tar does its work silently. The v (verbose) option makes tar print the name of each 
file it treats preceded by the function letter. With the t function, the verbose option gives more 
information about the tape entries than just their names. 


Tar prints the action to be taken followed by file name, then wait for user confirmation. If a 
word beginning with ‘y’ is given, the action is done. Any other input means don’t do it. 


Tar uses the next argument as the name of the archive instead of /dev/rmt?. If the name of the 
file is ‘—’, tar writes to standard output or reads from standard input, whichever is appropriate. 
Thus, tar can be used as the head or tail of a filter chain. Tar can also be used to move hierar- 
chies with the command 

cd fromdir; tar cf - . | (cd todir; tar xf -) 


Tar uses the next argument as the blocking factor for tape records. The default is 20 (the maxi- 
mum). This option should only be used with raw magnetic tape archives (See f above). The 
block size is determined automatically when reading tapes (key letters ‘x’ and ‘t’). 
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] tells tar to complain if it cannot resolve all of the links to the files dumped. If this is not 
specified, no error messages are printed. 


m tells tar not to restore the modification times. The modification time will be the time of extrac- 
tion. 
h Force tar to follow symbolic links as if they were normal files or directories. Normally, tar 


does not follow symbolic links. 


B Forces input and output blocking to 20 blocks per record. This option was added so that tar 
can work across a communications channel where the blocking may not be maintained. 


C If a file name is preceded by —C, then tar will perform a chdir(2) to that file name. This allows 
multiple directories not related by a close common parent to be archived using short relative 
path names. For example, to archive files from /usr/include and from /etc, one might use 

tar c -C /usr include -C / etc 


Previous restrictions dealing with tar’s inability to properly handle blocked archives have been lifted. 


FILES 
/dev/rmt? 
/tmp/tar* 


SEE ALSO 
tar(5) 


DIAGNOSTICS 
Complaints about bad key characters and tape read/write errors. 
Complaints if enough memory is not available to hold the link tables. 


BUGS 
There is no way to ask for the n-th occurrence of a file. 
Tape errors are handled ungracefully. 
The u option can be slow. 
The current limit on file name length is 100 characters. 
There is no way selectively to follow symbolic links. 
When extracting tapes created with the r or u options, directory modification times may not be set cor- 
rectly. 
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tbl — format tables for nroff or troff 


SYNOPSIS 


tbl [ files ] ... 


DESCRIPTION 


TBL(1) 


Tbl is a preprocessor for formatting tables for nroff or troff(1). The input files are copied to the standard 
output, except for lines between and are reformatted. Details are given in the tb/(1) reference manual. 


EXAMPLE 


As an example, letting \t represent a tab (which should be typed as a genuine tab) the input 


yields 


.TS 

css 

ccs 

ccc 

Inn. 

Household Population 
Town\tHouseholds 
\tNumber\tSize 
Bedminster\t789\t3.26 
Bernards Twp.\t3087\t3.74 
Bernardsville\t2018\t3.30 
Bound Brook\t3425\t3.04 
Branchburg\t1644\t3.49 
Bridgewater\t7897\t3.8 1 
Far Hills\t240\t3.19 


.TE 
Household Population 
Town Households 

Number _ Size 

Bedminster 789 3.26 

Bernards Twp. 3087 3.74 

Bernardsville 2018 3.30 

Bound Brook 3425 3.04 

Branchburg 1644 3.49 

Bridgewater 7897 3.81 

Far Hills 240 3.19 


If no arguments are given, thi reads the standard input, so it may be used as a filter. When tb/ is used with 


eqn or negn the tb! command should be first, to minimize the volume of data passed through pipes. 


SEE ALSO 


troff(1), eqn(1) 
M.E. Lesk, TBL. 
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NAME 
tc — photoypesetter simulator 


SYNOPSIS 
te[-t][-sN ][-pL ][ file ] 


DESCRIPTION 
Tc interprets its input (standard input default) as device codes for a Graphic Systems phototypesetter (cat). 
The standard output of fc is intended for a Tektronix 4015 (a 4014 terminal with ASCII and APL character 
sets). The sixteen typesetter sizes are mapped into the 4014’s four sizes; the entire TROFF character set is 
drawn using the 4014’s character generator, using overstruck combinations where necessary. Typical 
usage: 
troff -t file | tc 


At the end of each page tc waits for a newline (empty line) from the keyboard before continuing on to the 
next page. In this wait state, the command e will suppress the screen erase before the next page; sN will 
cause the next N pages to be skipped; and !line will send line to the shell. 


The command line options are: 

-t Don’t wait between pages; for directing output into a file. 

-sN Skip the first N pages. 

—pL Set page length to L. L may include the scale factors p (points), i (inches), ¢ (centimeters), and P 
(picas); default is picas. 

Multiply the default aspect ratio, 1.5, of a displayed page by Av. 


SEE ALSO 
troff(1), plot(1G) 


BUGS 
Font distinctions are lost. 
tc’s character set is limited to ASCII in just one size. 
The aspect ratio option is unbelievable. 
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NAME 

tcopy — copy a mag tape 
SYNOPSIS 

tcopy src [ dest ] 


DESCRIPTION 
Tcopy is designed to copy magnetic tapes. The only assumption made about the tape is that there are two 
tape marks at the end. Tcopy with only a source tape specified will print information about the sizes of 
records and tape files. If a destination is specified, then, a copy will be made of the source tape. The block- 
ing on the destination tape will be identical to that used on the source tape. Copying a tape will yield the 
same output as if just printing the sizes. 


SEE ALSO 
mtio(4) 
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NAME 
tee — pipe fitting 


SYNOPSIS 
tee [-i] [-a] [ file]... 


DESCRIPTION 
Tee transcribes the standard input to the standard output and makes copies in the files. Option —-i ignores 
interrupts; option —a causes the output to be appended to the files rather than overwriting them. 
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NAME 


telnet — user interface to the TELNET protocol 


SYNOPSIS 


telnet [ host [ port ] ] 


DESCRIPTION 


Telnet is used to communicate with another host using the TELNET protocol. If telnet is invoked without 
arguments, it enters command mode, indicated by its prompt (“‘telnet>’’). In this mode, it accepts and exe- 
cutes the commands listed below. If it is invoked with arguments, it performs an open command (see 
below) with those arguments. 


Once a connection has been opened, fe/net enters an input mode. The input mode entered will be either 
“‘character at a time’’ or ‘‘line by line’’ depending on what the remote system supports. 


In ‘‘character at a time’’ mode, most text typed is immediately sent to the remote host for processing. 


In “‘line by line’’ mode, all text is echoed locally, and (normally) only completed lines are sent to the 
remote host. The ‘‘local echo character’’ (initially ‘““E’’) may be used to turn off and on the local echo 
(this would mostly be used to enter passwords without the password being echoed). 


In either mode, if the Jocalchars toggle is TRUE (the default in line mode; see below), the user’s quit, intr, 
and flush characters are trapped locally, and sent as TELNET protocol sequences to the remote side. There 
are options (see toggle autoflush and toggle autosynch below) which cause this action to flush subsequent 
output to the terminal (until the remote host acknowledges the TELNET sequence) and flush previous ter- 
minal input (in the case of quit and intr). 


While connected to a remote host, tenet command mode may be entered by typing the telnet “‘escape char- 
acter’ (initially ‘“*]’’). When in command mode, the normal terminal editing conventions are available. 


COMMANDS 


The following commands are available. Only enough of each command to uniquely identify it need be 
typed (this is also true for arguments to the mode, set, toggle, and display commands). 


open host [ port | 
Open a connection to the named host. If no port number is specified, te/net will attempt to contact 
a TELNET server at the default port. The host specification may be either a host name (see 
hosts(5)) or an Internet address specified in the ‘‘dot notation’’ (see inet(3N)). 


close 
Close a TELNET session and return to command mode. 

quit 
Close any open TELNET session and exit telnet. An end of file Gn command mode) will also 
close a session and exit. 

Zz 
Suspend telnet. This command only works when the user is using the csh(1). 

mode type 
Type is either line (for ‘‘line by line’’ mode) or character (for ‘‘character at a time’’ mode). The 
remote host is asked for permission to go into the requested mode. If the remote host is capable of 
entering that mode, the requested mode will be entered. 

status 


Show the current status of telnet. This includes the peer one is connected to, as well as the current 
mode. 


display [ argument... | 
Displays all, or some, of the set and toggle values (see below). 
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Get help. With no arguments, telnet prints a help summary. If a command is specified, te/net will 
print the help information for just that command. 


send arguments 


Sends one or more special character sequences to the remote host. The following are the argu- 
ments which may be specified (more than one argument may be specified at a time): 


escape 


synch 


brk 


ao 


ayt 


ec 


el 


nop 


Sends the current telnet escape character (initially ‘‘*]’’). 


Sends the TELNET SYNCH sequence. This sequence causes the remote system to dis- 
card all previously typed (but not yet read) input. This sequence is sent as TCP urgent 
data (and may not work if the remote system is a 4.2 BSD system -- if it doesn’t work, a 


6699 


lower case “‘r’’ may be echoed on the terminal). 


Sends the TELNET BRK (Break) sequence, which may have significance to the remote 
system. 


Sends the TELNET IP (Interrupt Process) sequence, which should cause the remote sys- 
tem to abort the currently running process. 


Sends the TELNET AO (Abort Output) sequence, which should cause the remote system 
to flush all output from the remote system to the user’s terminal. 


Sends the TELNET AYT (Are You There) sequence, to which the remote system may or 
may not choose to respond. 


Sends the TELNET EC (Erase Character) sequence, which should cause the remote sys- 
tem to erase the last character entered. 


Sends the TELNET EL (Erase Line) sequence, which should cause the remote system to 
erase the line currently being entered. 


Sends the TELNET GA (Go Ahead) sequence, which likely has no significance to the 
remote system. 


Sends the TELNET NOP (No OPeration) sequence. 


Prints out help information for the send command. 


set argument value 
Set any one of a number of telnet variables to a specific value. The special value ‘‘off’’ turns off 
the function associated with the variable. The values of variables may be interrogated with the 
display command. The variables which may be specified are: 


echo 


4.2 Berkeley Distribution 


This is the value (initially ‘‘*E’’) which, when in “‘line by line’’ mode, toggles between 
doing local echoing of entered characters (for normal processing), and suppressing echo- 
ing of entered characters (for entering, say, a password). 
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escape 
This is the te/net escape character (initially ‘‘*[’’) which causes entry into telnet command 
mode (when connected to a remote system). 


interrupt 
If telnet is in localchars mode (see toggle localchars below) and the interrupt character is 
typed, a TELNET IP sequence (see send ip above) is sent to the remote host. The initial 
value for the interrupt character is taken to be the terminal’s intr character. 

quit 
If telnet is in localchars mode (see toggle localchars below) and the quit character is 
typed, a TELNET BRK sequence (see send brk above) is sent to the remote host. The 
initial value for the quit character is taken to be the terminal’s quit character. 


flushoutput 
If telnet is in localchars mode (see toggle localchars below) and the flushoutput character 
is typed, a TELNET AO sequence (see send ao above) is sent to the remote host. The 
initial value for the flush character is taken to be the terminal’s flush character. 


erase 
If telnet is in localchars mode (see toggle localchars below), and if telnet is operating in 
‘‘character at a time’’ mode, then when this character is typed, a TELNET EC sequence 
(see send ec above) is sent to the remote system. The initial value for the erase character 
is taken to be the terminal’s erase character. 


kill 
If telnet is in localchars mode (see toggle localchars below), and if telnet is operating in 
“*character at a time’’ mode, then when this character is typed, a TELNET EL sequence 
(see send e/ above) is sent to the remote system. The initial value for the kill character is 
taken to be the terminal’s kill character. 


eof 
If telnet is operating in ‘‘line by line’’ mode, entering this character as the first character 
on a line will cause this character to be sent to the remote system. The initial value of the 
eof character is taken to be the terminal’s eof character. 


toggle arguments... 
Toggle (between TRUE and FALSE) various flags that control how telnet responds to events. 
More than one argument may be specified. The state of these flags may be interrogated with the 
display command. Valid arguments are: 


localchars 
If this is TRUE, then the flush, interrupt, quit, erase, and kill characters (see set above) 
are recognized locally, and transformed into (hopefully) appropriate TELNET control 
sequences (respectively ao, ip, brk, ec, and el; see send above). The initial value for this 
toggle is TRUE in “‘line by line’’ mode, and FALSE in “‘character at a time’’ mode. 


autoflush 
If autoflush and localchars are both TRUE, then when the ao, intr, or quit characters are 
recognized (and transformed into TELNET sequences; see set above for details), telnet 
refuses to display any data on the user’s terminal until the remote system acknowledges 
(via a TELNET Timing Mark option) that it has processed those TELNET sequences. 
The initial value for this toggle is TRUE if the terminal user had not done an "stty 
nofish", otherwise FALSE (see stty(/)). 


autosynch 
If autosynch and localchars are both TRUE, then when either the intr or quit characters is 
typed (see set above for descriptions of the intr and quit characters), the resulting 
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debug 


options 


netdata 
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TELNET sequence sent is followed by the TELNET SYNCH sequence. This procedure 
should cause the remote system to begin throwing away all previously typed input until 
both of the TELNET sequences have been read and acted upon. The initial value of this 
toggle is FALSE. 


Toggle carriage return mode. When this mode is enabled, most carriage return characters 
received from the remote host will be mapped into a carriage return followed by a line 
feed. This mode does not affect those characters typed by the user, only those received 
from the remote host. This mode is not very useful unless the remote host only sends car- 
riage return, but never line feed. The initial value for this toggle is FALSE. 


Toggles socket level debugging (useful only to the superuser). The initial value for this 
toggle is FALSE. 


Toggles the display of some internal te/net protocol processing (having to do with TEL- 
NET options). The initial value for this toggle is FALSE. 


Toggles the display of all network data (in hexadecimal format). The initial value for this 
toggle is FALSE. 


Displays the legal toggle commands. 


There is no adequate way for dealing with flow control. 


On some remote systems, echo has to be turned off manually when in ‘“‘line by line’’ mode. 


There is enough settable state to justify a .telnetrc file. 


No capability for a .telnetrc file is provided. 


In ‘‘line by line’ 


> mode, the terminal’s eof character is only recognized (and sent to the remote system) 


when it is the first character on a line. 
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NAME 
test — condition command 


SYNOPSIS 
test expr 


DESCRIPTION 
test evaluates the expression expr, and if its value is true then returns zero exit status; otherwise, a non zero 
exit status is returned. fest returns a non zero exit if there are no arguments. 


The following primitives are used to construct expr. 
-r file true if the file exists and is readable. 


—w file true if the file exists and is writable. 


-f file true if the file exists and is not a directory. 

-d file true if the file exists exists and is a directory. 

-s file true if the file exists and has a size greater than zero. 
-t [ fildes | 


true if the open file whose file descriptor number is fildes (1 by default) is associated with a ter- 
minal device. 


-z sl true if the length of string s/ is zero. 

—n sl true if the length of the string s/ is nonzero. 
sl=s2 true if the strings s/ and s2 are equal. 
sl!=s2 true if the strings s/ and s2 are not equal. 
sl true if s/ is not the null string. 


nl -eq n2 true if the integers n/ and n2 are algebraically equal. Any of the comparisons —ne, —gt, —ge, It, 
or -le may be used in place of -eq. 


These primaries may be combined with the following operators: 


! unary negation operator 
-a binary and operator 
-0 binary or operator 


(expr) parentheses for grouping. 


—a has higher precedence than —o. Notice that all the operators and flags are separate arguments to fest. 
Notice also that parentheses are meaningful to the Shell and must be escaped. 


SEE ALSO 
sh(1), find(1) 
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NAME 
tftp — trivial file transfer program 


SYNOPSIS 
tftp [ host ] 


DESCRIPTION 
Tftp is the user interface to the Internet TFTP (Trivial File Transfer Protocol), which allows users to trans- 
fer files to and from a remote machine. The remote host may be specified on the command line, in which 
case tftp uses host as the default host for future transfers (see the connect command below). 


COMMANDS 
Once ¢ftp is running, it issues the prompt tftp> and recognizes the following commands: 


connect host-name [ port | 
Set the host (and optionally port) for transfers. Note that the TFTP protocol, unlike the FTP pro- 
tocol, does not maintain connections betweeen transfers; thus, the connect command does not 
actually create a connection, but merely remembers what host is to be used for transfers. You do 
not have to use the connect command; the remote host can be specified as part of the get or put 
commands. 


mode transfer-mode 
Set the mode for transfers; transfer-mode may be one of ascii or binary. The default is ascii. 


put file 

put localfile remotefile 

put file! file2 ... fileN remote-directory 
Put a file or set of files to the specified remote file or directory. The destination can be in one of 
two forms: a filename on the remote host, if the host has already been specified, or a string of the 
form host:filename to specify both a host and filename at the same time. If the latter form is used, 
the hostname specified becomes the default for future transfers. If the remote-directory form is 
used, the remote host is assumed to be a UNIX machine. 


get filename 

get remotename localname 

get file! file2 ... fileN 
Get a file or set of files from the specified sources. Source can be in one of two forms: a filename 
on the remote host, if the host has already been specified, or a string of the form host:filename to 
specify both a host and filename at the same time. If the latter form is used, the last hostname 
specified becomes the default for future transfers. 


quit Exit tftp. An end of file also exits. 
verbose Toggle verbose mode. 

trace Toggle packet tracing. 

status Show current status. 


rexmt retransmission-timeout 
Set the per-packet retransmission timeout, in seconds. 


timeout total-transmission-timeout 
Set the total transmission timeout, in seconds. 


ascii § Shorthand for "mode ascii" 
binary Shorthand for "mode binary" 


? [ commana-name ... | 
Print help information. 
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BUGS 
Because there is no user-login or validation within the TFTP protocol, the remote site will probably have 
some sort of file-access restrictions in place. The exact methods are specific to each site and therefore 
difficult to document here. 
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NAME 
time — time a command 


SYNOPSIS 
time command 


DESCRIPTION 
The given command is executed; after it is complete, time prints the elapsed time during the command, the 
time spent in the system, and the time spent in execution of the command. Times are reported in seconds. 


On a PDP-11, the execution time can depend on what kind of memory the program happens to land in; the 
user time in MOS is often half what it is in core. 


The times are printed on the diagnostic output stream. 
Time is built in to csh(1), using a different output format. 


BUGS 
Elapsed time is accurate to the second, while the CPU times are measured to the 100th second. Thus the 
sum of the CPU times can be up to a second larger than the elapsed time. 


Time is a built-in command to csh(1), with a much different syntax. This command is available as 
“*/bin/time’’ to csh users. 
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NAME 
tip, cu — connect to a remote system 


SYNOPSIS 
tip [-v ] [-speed ] system-name 
tip [ -v ] [-speed | phone-number 
cu phone-number [ -t ] [-s speed ][ -a acu ][-l line ][-#] 


DESCRIPTION 
Tip and cu establish a full-duplex connection to another machine, giving the appearance of being logged in 
directly on the remote cpu. It goes without saying that you must have a login on the machine (or equiva- 
lent) to which you wish to connect. The preferred interface is tip. The cu interface is included for those 
people attached to the ‘‘call UNIX’’ command of version 7. This manual page describes only tip. 


Typed characters are normally transmitted directly to the remote machine (which does the echoing as well). 
A tilde (*’) appearing as the first character of a line is an escape signal; the following are recognized: 


“D~. Drop the connection and exit (you may still be logged in on the remote machine). 


“ce [name] Change directory to name (no argument implies change to your home directory). 


as Escape to a shell (exiting the shell will return you to tip). 
> Copy file from local to remote. Tip prompts for the name of a local file to transmit. 
“< Copy file from remote to local. Tip prompts first for the name of the file to be sent, then for a 


command to be executed on the remote machine. 


“p from [ to | 
Send a file to a remote UNIX host. The put command causes the remote UNIX system to run 
the command string “‘cat > ’to’’’, while tip sends it the “‘from’’ file. If the ‘‘to’’ file isn’t 
specified the “‘from’’ file name is used. This command is actually a UNIX specific version of 
the *“>’? command. 


“t from [to | 
Take a file from a remote UNIX host. As in the put command the “‘to’’ file defaults to the 
““from’’ file name if it isn’t specified. The remote host executes the command string ‘“‘cat 
from’ ;echo *A’’ to send the file to tip. 


| Pipe the output from a remote command to a local UNIX process. The command string sent to 
the local UNIX system is processed by the shell. 


“$ Pipe the output from a local UNIX process to the remote host. The command string sent to the 
local UNIX system is processed by the shell. 

“# Send a BREAK to the remote system. For systems which don’t support the necessary ioctl call 
the break is simulated by a sequence of line speed changes and DEL characters. 

“s Set a variable (see the discussion below). 

~“L Stop tip (only available with job control). 

“Y Stop only the ‘‘local side’’ of tip (only available with job control); the “‘remote side’’ of tip, 


the side that displays output from the remote host, is left running. 


? Get a summary of the tilde escapes 


Tip uses the file /etc/remote to find how to reach a particular system and to find out how it should operate 
while talking to the system; refer to remote(5) for a full description. Each system has a default baud rate 
with which to establish a connection. If this value is not suitable, the baud rate to be used may be specified 
on the command line, e.g. ‘“tip -300 mds’’. 
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When tip establishes a connection it sends out a connection message to the remote system; the default 
value, if any, is defined in /etc/remote. 


When fip prompts for an argument (e.g. during setup of a file transfer) the line typed may be edited with the 
standard erase and kill characters. A null line in response to a prompt, or an interrupt, will abort the dia- 
logue and return you to the remote machine. 


Tip guards against multiple users connecting to a remote system by opening modems and terminal lines 
with exclusive access, and by honoring the locking protocol used by uucp(1C). 


During file transfers tip provides a running count of the number of lines transferred. When using the ~> and 
~“< commands, the ‘‘eofread’’ and ‘‘eofwrite’’ variables are used to recognize end-of-file when reading, and 
specify end-of-file when writing (see below). File transfers normally depend on tandem mode for flow con- 
trol. If the remote system does not support tandem mode, “‘echocheck’’ may be set to indicate tip should 
synchronize with the remote system on the echo of each transmitted character. 


When tip must dial a phone number to connect to a system it will print various messages indicating its 
actions. Tip supports the DEC DN-11 and Racal-Vadic 831 auto-call-units; the DEC DFO2 and DFO3, 
Ventel 212+, Racal-Vadic 3451, and Bizcomp 1031 and 1032 integral call unit/modems. 


VARIABLES 


Tip maintains a set of variables which control its operation. Some of these variable are read-only to normal 
users (root is allowed to change anything of interest). Variables may be displayed and set through the “‘s’’ 
escape. The syntax for variables is patterned after vi(1) and Mail(1). Supplying ‘‘all’’ as an argument to 
the set command displays all variables readable by the user. Alternatively, the user may request display of 
a particular variable by attaching a ‘?’ to the end. For example ‘‘escape?’’ displays the current escape 
character. 


Variables are numeric, string, character, or boolean values. Boolean variables are set merely by specifying 
their name; they may be reset by prepending a ‘!’ to the name. Other variable types are set by concatenat- 
ing an ‘=’ and the value. The entire assignment must not have any blanks in it. A single set command may 
be used to interrogate as well as set a number of variables. Variables may be initialized at run time by plac- 
ing set commands (without the ‘“s’’ prefix in a file .tiprc in one’s home directory). The —v option causes 
tip to display the sets as they are made. Certain common variables have abbreviations. The following is a 


list of common variables, their abbreviations, and their default values. 


beautify 
(bool) Discard unprintable characters when a session is being scripted; abbreviated be. 


baudrate 
(num) The baud rate at which the connection was established; abbreviated ba. 


dialtimeout 
(num) When dialing a phone number, the time (in seconds) to wait for a connection to be estab- 
lished; abbreviated dial. 


echocheck 
(bool) Synchronize with the remote host during file transfer by waiting for the echo of the last 
character transmitted; default is off. 


eofread 
(str) The set of characters which signify and end-of-tranmission during a ~< file transfer command; 
abbreviated eofr. 


eofwrite 
(str) The string sent to indicate end-of-transmission during a ~> file transfer command; abbreviated 


eofw. 
eol 
(str) The set of characters which indicate an end-of-line. Tip will recognize escape characters only 
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FILES 


after an end-of-line. 


escape 
(char) The command prefix (escape) character; abbreviated es; default value is “~’. 

exceptions 
(str) The set of characters which should not be discarded due to the beautification switch; abbrevi- 
ated ex; default value is ‘‘\t\n\f\b’’. 

force 
(char) The character used to force literal data transmission; abbreviated fo; default value is ‘*P’. 

framesize 
(num) The amount of data (in bytes) to buffer between file system writes when receiving files; 
abbreviated fr. 

host 
(str) The name of the host to which you are connected; abbreviated ho. 

prompt 
(char) The character which indicates and end-of-line on the remote host; abbreviated pr; default 
value is ‘\n’. This value is used to synchronize during data transfers. The count of lines trans- 
ferred during a file transfer command is based on recipt of this character. 

raise 
(bool) Upper case mapping mode; abbreviated ra; default value is off. When this mode is enabled, 
all lower case letters will be mapped to upper case by tip for transmission to the remote machine. 

raisechar 
(char) The input character used to toggle upper case mapping mode; abbreviated rc; default value 
is ‘A’, 

record 
(str) The name of the file in which a session script is recorded; abbreviated rec; default value is 
“‘tip.record’’. 

script 
(bool) Session scripting mode; abbreviated sc; default is off. When script is true, tip will record 
everything transmitted by the remote machine in the script record file specified in record. If the 
beautify switch is on, only printable ASCII characters will be included in the script file (those 
characters betwee 040 and 0177). The variable exceptions is used to indicate characters which are 
an exception to the normal beautification rules. 

tabexpand 
(bool) Expand tabs to spaces during file transfers; abbreviated tab; default value is false. Each tab 
is expanded to 8 spaces. 

verbose 
(bool) Verbose mode; abbreviated verb; default is true. When verbose mode is enabled, tip prints 
messages while dialing, shows the current number of lines transferred during a file transfer opera- 
tions, and more. 

SHELL 
(str) The name of the shell to use for the ~! command; default value is ‘‘/bin/sh’’, or taken from the 
environment. 

HOME 
(str) The home directory to use for the ~c command; default value is taken from the environment. 

/etc/remote global system descriptions 
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/etc/phones global phone number data base 
${REMOTE} private system descriptions 
${PHONES } private phone numbers 
*/.tipre initialization file. 
/usr/spool/uucp/LCK..* lock file to avoid conflicts with uucp 
DIAGNOSTICS 
Diagnostics are, hopefully, self explanatory. 
SEE ALSO 


remote(5), phones(5) 


BUGS 
The full set of variables is undocumented and should, probably, be paired down. 
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NAME 

tk — paginator for the Tektronix 4014 
SYNOPSIS 

tk [-t][-N ][-pZ ] [ file ] 
DESCRIPTION 


The output of tk is intended for a Tektronix 4014 terminal. 7k arranges for 66 lines to fit on the screen, 
divides the screen into N columns, and contributes an eight space page offset in the (default) single-column 
case. Tabs, spaces, and backspaces are collected and plotted when necessary. Teletype Model 37 half- and 
reverse-line sequences are interpreted and plotted. At the end of each page tk waits for a newline (empty 
line) from the keyboard before continuing on to the next page. In this wait state, the command !command 
will send the command to the shell. 


The command line options are: 

-t Don’t wait between pages; for directing output into a file. 

-N Divide the screen into N columns and wait after the last column. 
—pL Set page length to L lines. 


SEE ALSO 
pr(1) 
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NAME 

tn3270 — full-screen remote login to IBM VM/CMS 
SYNOPSIS 

tn3270 sysname 
DESCRIPTION 


FILES 


Tn3270 permits a full-screen, full-duplex connection from a VAX UNIX machine to an IBM machine run- 
ning VM/CMS giving the appearance of being logged in directly to the remote machine on an IBM 3270 
terminal. Of course you must have an account on the machine to which you wish to connect in order to log 
in. 7n3270 looks to the user in many respects like the Yale ASCII Terminal Communication System II. 
Tn3270 is actually a modification of the Arpanet TELNET user interface (see te/net(1)) that interprets and 
generates raw 3270 control streams. 


Emulation of the 3270 terminal is done in the Unix process. This emulation involves mapping 3270-style 
commands from the host into appropriate sequences to control the user’s terminal screen. 73270 uses 
curses(3x) and the /etc/termcap file to do this. The emulation also involves simulating the special 3270 
keyboard keys (program function keys, etc.) by mapping sequences of keystrokes from the ASCII key- 
board into appropriate 3270 control strings. This mapping is terminal dependent and is specified in a 
description file, /etc/map3270, (see map3270(5)) or in an environment variable MAP3270 (see mset(1)). 
Any special function keys on the ASCII keyboard are used whenever possible. If an entry for the user’s ter- 
minal is not found, tn3270 looks for an entry for the terminal type unknown. If this is not found, 3270 
uses a default keyboard mapping (see map3270(5)). 


The first character of each special keyboard mapping sequence is either an ASCII escape (ESC), a control 
character, or an ASCII delete (DEL). If the user types an unrecognized function key sequence, tn3270 
sends an ASCII bell (BEL), or a visual bell if defined in the user’s termcap entry, to the user’s terminal and 
nothing is sent to the IBM host. 


If 13270 is invoked without specifying a remote host system name, it enters local command mode, indi- 
cated by the prompt “‘tn3270>’’. In this mode, #n3270 accepts and executes the following commands: 


open connect to a remote host 
close close the current connection 
quit exit tn3270 

Z suspend tn3270 

status print connection status 

? print help information 


Other common telnet commands are not available in tn3270. Tn3270 command mode may also be entered, 
after connecting to a host, by typing a special escape character (typically control-C). 


While in command mode, any host login session is still alive but temporarily suspended. The host login 
session may be resumed by entering an empty line (press the RETURN key) in response to the command 
prompt. A session may be terminated by logging off the foreign host, or by typing ‘‘quit’’ or ‘‘close’’ 
while in local command mode. 


/etc/termcap 
/etc/map3270 


AUTHOR 


Greg Minshall 


SEE ALSO 


mset(1), telnet(1), termcap(3x), termcap(5), map3270(5), Yale ASCH Terminal Communication System IT 
Program Description/Operator’s Manual (IBM SB30-1911) 
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BUGS 
Performance is slow and uses system resources prodigiously. 


Not all 3270 functions are supported, nor all Yale enhancements. 
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NAME 
touch — update date last modified of a file 


SYNOPSIS 
touch [ -¢ ] [ -f ] file ... 


DESCRIPTION 
Touch attempts to set the modified date of each file. If a file exists, this is done by reading a character from 
the file and writing it back. Ifa file does not exist, an attempt will be made to create it unless the -c option 
is specified. The -f option will attempt to force the touch in spite of read and write permissions on a file. 


SEE ALSO 
utimes(2) 
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UNIX Programmer’s Manual TP(1) 


tp — manipulate tape archive 


SYNOPSIS 
tp [ key ] 
DESCRIPTION 


[name ... | 


Tp saves and restores files on DECtape or magtape. Its actions are controlled by the key argument. The key 
is a string of characters containing at most one function letter and possibly one or more function modifiers. 
Other arguments to the command are file or directory names specifying which files are to be dumped, 
restored, or listed. In all cases, appearance of a directory name refers to the files and (recursively) subdirec- 
tories of that directory. 


The function portion of the key is specified by one of the following letters: 


r 


The named files are written on the tape. If files with the same names already exist, they are 
replaced. ‘Same’ is determined by string comparison, so ‘./abc’ can never be the same as 
‘/ust/dmr/abc’ even if ‘/usr/dmr’ is the current directory. If no file argument is given, ‘.’ is the 
default. 


updates the tape. u is like r, but a file is replaced only if its modification date is later than the 
date stored on the tape; that is to say, if it has changed since it was dumped. u is the default com- 
mand if none is given. 


deletes the named files from the tape. At least one name argument must be given. This function 
is not permitted on magtapes. 


extracts the named files from the tape to the file system. The owner and mode are restored. If no 
file argument is given, the entire contents of the tape are extracted. 


lists the names of the specified files. If no file argument is given, the entire contents of the tape is 
listed. 


The following characters may be used in addition to the letter which selects the function desired. 


m 
0,...57 


FILES 
/dev/tap? 
/dev/rmt? 


7th Edition 


Specifies magtape as opposed to DECtape. 


This modifier selects the drive on which the tape is mounted. For DECtape, x is default; for 
magtape ‘0’ is the default. 


Normally ¢p does its work silently. The v (verbose) option causes it to type the name of each 
file it treats preceded by the function letter. With the t function, v gives more information 
about the tape entries than just the name. 


means a fresh dump is being created; the tape directory is cleared before beginning. Usable 
only with r and u. This option is assumed with magtape since it is impossible to selectively 
overwrite magtape. 


Errors reading and writing the tape are noted, but no action is taken. Normally, errors cause a 
return to the command level. 


Use the first named file, rather than a tape, as the archive. This option currently acts like m; 
i.e. r implies c, and neither d nor u are permitted. 


causes tp to pause before treating each file, type the indicative letter and the file name (as with 
v) and await the user’s response. Response y means ‘yes’, so the file is treated. Null response 
means ‘no’, and the file does not take part in whatever is being done. Response x means ‘exit’; 
the tp command terminates immediately. In the x function, files previously asked about have 
been extracted already. With r, u, and d no change has been made to the tape. 
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SEE ALSO 
ar(1), tar(1) 


DIAGNOSTICS 
Several; the non-obvious one is ‘Phase error’, which means the file changed after it was selected for dump- 


ing but before it was dumped. 


BUGS 
A single file with several links to it is treated like several files. 


Binary-coded control information makes magnetic tapes written by ¢p difficult to carry to other machines; 
tar(1) avoids the problem. 
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NAME 
tr — translate characters 


SYNOPSIS 
tr [-cds ] [ string] [ string2 ] ] 


DESCRIPTION 
Tr copies the standard input to the standard output with substitution or deletion of selected characters. 
Input characters found in string] are mapped into the corresponding characters of string2. When string2 is 
short it is padded to the length of string] by duplicating its last character. Any combination of the options 
—cds may be used: —c complements the set of characters in string] with respect to the universe of characters 
whose ASCII codes are 01 through 0377 octal; -d deletes all input characters in string]; -s squeezes all 
strings of repeated output characters that are in string2 to single characters. 


In either string the notation a—b means a range of characters from a to b in increasing ASCII order. The 
character ‘\’ followed by 1, 2 or 3 octal digits stands for the character whose ASCII code is given by those 
digits. A ‘V followed by any other character stands for that character. 


The following example creates a list of all the words in ‘filel’ one per line in ‘file2’, where a word is taken 
to be a maximal string of alphabetics. The second string is quoted to protect ‘\’ from the Shell. 012 is the 
ASCII code for newline. 


tr -—cs A—Za—z “\012° <file1 >file2 


SEE ALSO 
ed(1), ascii(7), expand(1) 


BUGS 
Won’t handle ASCII NUL in string/ or string2; always deletes NUL from input. 


7th Edition April 29, 1985 1 


TROFF (1) UNIX Programmer’s Manual TROFF (1) 


NAME 


troff, nroff — text formatting and typesetting 


SYNOPSIS 


troff [ option ] ... [ file] ... 
nroff [ option ] ... [ file ] ... 


DESCRIPTION 


FILES 


Troff formats text in the named files for printing on a Graphic Systems C/A/T phototypesetter; nroff is used 
for for typewriter-like devices. Their capabilities are described in the Nroff/Troff user’s manual. 


If no file argument is present, the standard input is read. An argument consisting of a single minus (—) is 
taken to be a file name corresponding to the standard input. The options, which may appear in any order so 
long as they appear before the files, are: 


-olist Print only pages whose page numbers appear in the comma-separated /ist of numbers and ranges. 
A range N—M means pages N through M; an initial -N means from the beginning to page N; and a 
final N— means from N to the end. 


—nN Number first generated page N. 


-sN Stop every N pages. Nroff will halt prior to every N pages (default N=1) to allow paper loading or 
changing, and will resume upon receipt of a newline. Troff will stop the phototypesetter every N 
pages, produce a trailer to allow changing cassettes, and resume when the typesetter’s start button 
is pressed. 


—mname 
Prepend the macro file /usr/lib/tmac/tmac.name to the input files. 


-raN _ Set register a (one-character) to N. 


-i Read standard input after the input files are exhausted. 

-q Invoke the simultaneous input-output mode of the rd request. 

Troff only 

-t Direct output to the standard output instead of the phototypesetter. 

-f Refrain from feeding out paper and stopping phototypesetter at the end of the run. 

-w Wait until phototypesetter is available, if currently busy. 

-b Report whether the phototypesetter is busy or available. No text processing is done. 

-a Send a printable ASCII approximation of the results to the standard output. 

—pN Print all characters in point size N while retaining all prescribed spacings and motions, to reduce 
phototypesetter elapsed time. 

—-Ffontdir 


The directory fontdir contains the font width tables instead of the default directory /usr/lib/fonts. 
This option can be used to produce output for devices besides the phototypesetter. 


If the file “usr/adm/tracct is writable, troff keeps phototypesetter accounting records there. The integrity of 
that file may be secured by making froffa ’set user-id’ program. 


/tmp/ta* temporary file 
/asr/lib/tmac/tmac.* standard macro files 
/asr/lib/term/* terminal driving tables for nroff 
/asr/lib/font/* font width tables for troff 
/dev/cat phototypesetter 

/asr/adm/tracct accounting statistics for /dev/cat 
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SEE ALSO 
J. F. Ossanna, Nroff/Troff user’s manual 
B. W. Kernighan, A TROFF Tutorial 
eqn(1), tbl(1), ms(7), me(7), man(7), col(1) 
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NAME 
true, false — provide truth values 


SYNOPSIS 
true 


false 


DESCRIPTION 
True and false are usually used in a Bourne shell script. They test for the appropriate status "true" or 
"false" before running (or failing to run) a list of commands. 


EXAMPLE 
while true 
do 
command list 
done 
SEE ALSO 
csh(1), sh(1), false(1) 
DIAGNOSTICS 


True has exit status zero. 
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NAME 


tset — terminal dependent initialization 


SYNOPSIS 


tset [ options | [ -m [ident][test baudrate]:type ] ... [ type ] 


reset [ options ] [ —m [ident][test baudrate]:type ] ... [ type ] 


DESCRIPTION 


Tset sets up your terminal when you first log in to a UNIX system. It does terminal dependent processing 
such as setting erase and kill characters, setting or resetting delays, sending any sequences needed to prop- 
erly initialized the terminal, and the like. It first determines the type of terminal involved, and then does 
necessary initializations and mode settings. The type of terminal attached to each UNIX port is specified in 
the /etc/ttys(5) database. Type names for terminals may be found in the termcap(5) database. If a port is 
not wired permanently to a specific terminal (not hardwired) it will be given an appropriate generic 
identifier such as dialup. 


In the case where no arguments are specified, tset simply reads the terminal type out of the environment 
variable TERM and re-initializes the terminal. The rest of this manual concerns itself with mode and envi- 
ronment initialization, typically done once at login, and options used at initialization time to determine the 
terminal type and set up terminal modes. 


When used in a startup script (.profile for sh(1) users or .login for csh(1) users) it is desirable to give infor- 
mation about the type of terminal you will usually use on ports which are not hardwired. These ports are 
identified in /etc/ttys as dialup or plugboard or arpanet, etc. To specify what terminal type you usually use 
on these ports, the -m (map) option flag is followed by the appropriate port type identifier, an optional baud 
rate specification, and the terminal type. (The effect is to “‘map’’ from some conditions to a terminal type, 
that is, to tell rset ‘‘If ’m on this kind of port, guess that I’m on that kind of terminal’’.) If more than one 
mapping is specified, the first applicable mapping prevails. A missing port type identifier matches all 
identifiers. Any of the alternate generic names given in termcap may be used for the identifier. 


A baudrate is specified as with stty(1), and is compared with the speed of the diagnostic output (which 
should be the control terminal). The baud rate test may be any combination of: >, @, <, and !; @ means 
‘‘at’’ and ! inverts the sense of the test. To avoid problems with metacharacters, it is best to place the entire 
argument to —m within “‘”’ characters; users of csh(1) must also put a “‘\’’ before any used here. 


Thus 


coy? 


tset —m “dialup>300:adm3a‘ -m dialup:dw2 -m “plugboard:?adm3a* 


causes the terminal type to be set to an adm3a if the port in use is a dialup at a speed greater than 300 baud; 
to a dw2 if the port is (otherwise) a dialup (i.e. at 300 baud or less). (NOTE: the examples given here 
appear to take up more than one line, for text processing reasons. When you type in real tset commands, 
you must enter them entirely on one line.) If the type finally determined by tset begins with a question 
mark, the user is asked if s/he really wants that type. A null response means to use that type; otherwise, 
another type can be entered which will be used instead. Thus, in the above case, the user will be queried on 
a plugboard port as to whether they are actually using an adm3a. 


If no mapping applies and a final type option, not preceded by a —m, is given on the command line then that 
type is used; otherwise the type found in the /etc/ttys database will be taken to be the terminal type. This 
should always be the case for hardwired ports. 


It is usually desirable to return the terminal type, as finally determined by tset, and information about the 
terminal’s capabilities to a shell’s environment. This can be done using the — option; using the Bourne 
shell, sh(1): 


export TERM; TERM=tset — options... 
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or using the C shell, csh(1): 
setenv TERM ‘tset - options... 


With csh it is preferable to use the following command in your .login file to initialize the TERM and 
TERMCAP environment variables at the same time. 


eval *tset -s options...” 

It is also convenient to make an alias in your .cshre: 
alias tset “eval “tset —s \!*** 

This allows the command: 
tset 2621 


to be invoked at any time to set the terminal and environment. Note to Bourne Shell users: It is not possi- 
ble to get this aliasing effect with a shell script, because shell scripts cannot set the environment of their 
parent. (If a process could set its parent’s environment, none of this nonsense would be necessary in the 
first place.) 


These commands cause tsef to place the name of your terminal in the variable TERM in the environment; 
see environ(7). 


Once the terminal type is known, tset engages in terminal driver mode setting. This normally involves 
sending an initialization sequence to the terminal, setting the single character erase (and optionally the 
line-kill (full line erase)) characters, and setting special character delays. Tab and newline expansion are 
turned off during transmission of the terminal initialization sequence. 


On terminals that can backspace but not overstrike (such as a CRT), and when the erase character is the 
default erase character (‘#’ on standard systems), the erase character is changed to BACKSPACE (Control-H). 


The options are: 


ec set the erase character to be the named character c on all terminals, the default being the backspace 
character on the terminal, usually “H. The character c can either be typed directly, or entered using 
the hat notation used here. 


-kc is similar to -e but for the line kill character rather than the erase character; c defaults to “X (for 
purely historical reasons). The kill characters is left alone if -k is not specified. The hat notation 
can also be used for this option. 


-ic is similar to -e but for the interrupt character rather than the erase character; c defaults to “C. The 
hat notation can also be used for this option. 


- The name of the terminal finally decided upon is output on the standard output. This is intended to 
be captured by the shell and placed in the environment variable TERM. 


Ss Print the sequence of csh commands to initialize the environment variables TERM and TERM- 
CAP based on the name of the terminal finally decided upon. 


—n On systems with the Berkeley 4BSD tty driver, specifies that the new tty driver modes should be 
initialized for this terminal. For a CRT, the CRTERASE and CRTKILL modes are set only if the 
baud rate is 1200 or greater. See tty(4) for more detail. 


-I suppresses transmitting terminal initialization strings. 
-Q suppresses printing the ““Erase set to’’ and ‘‘Kill set to’’ messages. 


If tset is invoked as reset, it will set cooked and echo modes, turn off cbreak and raw modes, turn on new- 
line translation, and restore special characters to a sensible state before any terminal dependent processing 
is done. Any special character that is found to be NULL or “‘—1”’ is reset to its default value. All arguments 
to tset may be used with reset. 
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This is most useful after a program dies leaving a terminal in a funny state. You may have to type 
““<LF>reset<LF>’’ to get it to work since <CR> may not work in this state. Often none of this will echo. 


EXAMPLES 


These examples all assume the Bourne shell and use the - option. If you use csh, use one of the variations 
described above. Note that a typical use of tset in a .profile or .login will also use the -e and —-k options, 
and often the —n or —Q options as well. These options have not been included here to keep the examples 
small. (NOTE: some of the examples given here appear to take up more than one line, for text processing 
reasons. When you type in real tset commands, you must enter them entirely on one line.) 


At the moment, you are on a 2621. This is suitable for typing by hand but not for a .profile, unless you are 
always on a 2621. 


export TERM; TERM="tset — 2621° 


You have an h19 at home which you dial up on, but your office terminal is hardwired and known in 
/etc/ttys. 


export TERM; TERM="tset — —m dialup:h19 


You have a switch which connects everything to everything, making it nearly impossible to key on what 
port you are coming in on. You use a vt100 in your office at 9600 baud, and dial up to switch ports at 1200 
baud from home on a 2621. Sometimes you use someone elses terminal at work, so you want it to ask you 
to make sure what terminal type you have at high speeds, but at 1200 baud you are always on a 2621. Note 
the placement of the question mark, and the quotes to protect the greater than and question mark from inter- 
pretation by the shell. 


export TERM; TERM="tset — —m ’switch>1200:?vt100’ —m ’switch<=1200:2621’ 


All of the above entries will fall back on the terminal type specified in /etc/ttys if none of the conditions 
hold. The following entry is appropriate if you always dial up, always at the same baud rate, on many dif- 
ferent kinds of terminals. Your most common terminal is an adm3a. It always asks you what kind of ter- 
minal you are on, defaulting to adm3a. 


export TERM; TERM= tset — ?adm3a° 


If the file /etc/ttys is not properly installed and you want to key entirely on the baud rate, the following can 
be used: 


export TERM; TERM= tset — —m ’>1200:vt100’ 2621° 


Here is a fancy example to illustrate the power of tset and to hopelessly confuse anyone who has made it 
this far. You dial up at 1200 baud or less on a concept100, sometimes over switch ports and sometimes 
over regular dialups. You use various terminals at speeds higher than 1200 over switch ports, most often 
the terminal in your office, which is a vt100. However, sometimes you log in from the university you used 
to go to, over the ARPANET; in this case you are on an ALTO emulating a dm2500. You also often log in 
on various hardwired ports, such as the console, all of which are properly entered in /etc/ttys. You want 
your erase character set to control H, your kill character set to control U, and don’t want tset to print the 
“Erase set to Backspace, Kill set to Control U’’ message. 


export TERM; TERM="tset —-e —k"U -Q — —m ’switch<=1200:concept100’ —m ’switch:?vt100’ —m 
dialup:concept100 —m arpanet:dm2500° 


FILES 
/etc/ttys port name to terminal type mapping database 
/etc/termcap terminal capability database 

SEE ALSO 


csh(1), sh(1), stty(1), ttys(5), termcap(5), environ(7) 
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BUGS 
The tset command is one of the first commands a user must master when getting started on a UNIX system. 
Unfortunately, it is one of the most complex, largely because of the extra effort the user must go through to 
get the environment of the login shell set. Something needs to be done to make all this simpler, either the 
login(1) program should do this stuff, or a default shell alias should be made, or a way to set the environ- 
ment of the parent should exist. 


This program can’t intuit personal choices for erase, interrupt and line kill characters, so it leaves these set 
to the local system standards. 
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NAME 
tsort — topological sort 


SYNOPSIS 
tsort [ file ] 


DESCRIPTION 
Tsort produces on the standard output a totally ordered list of items consistent with a partial ordering of 
items mentioned in the input file. If no file is specified, the standard input is understood. 


The input consists of pairs of items (nonempty strings) separated by blanks. Pairs of different items indi- 
cate ordering. Pairs of identical items indicate presence, but not ordering. 


SEE ALSO 
lorder(1) 


DIAGNOSTICS 
Odd data: there is an odd number of fields in the input file. 


BUGS 
Uses a quadratic algorithm; not worth fixing for the typical use of ordering a library archive file. 
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NAME 
tty — get terminal name 
SYNOPSIS 
tty [-s ] 
DESCRIPTION 
Tty prints the pathname of the user’s terminal unless the —s (silent) is given. In either case, the exit value is 
zero if the standard input is a terminal and one if it is not. 


DIAGNOSTICS 
‘not a tty’ if the standard input file is not a terminal. 
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ul — do underlining 


SYNOPSIS 


ul [ -i ] [-t terminal ] [ name... | 


DESCRIPTION 


UI reads the named files (or standard input if none are given) and translates occurrences of underscores to 
the sequence which indicates underlining for the terminal in use, as specified by the environment variable 
TERM. The -t option overrides the terminal kind specified in the environment. The file /etc/termcap is 
read to determine the appropriate sequences for underlining. If the terminal is incapable of underlining, but 
is capable of a standout mode then that is used instead. If the terminal can overstrike, or handles underlin- 
ing automatically, ul degenerates to cat(1). If the terminal cannot underline, underlining is ignored. 


a) 


The -i option causes u/ to indicate underlining onto by a separate line containing appropriate dashes ‘—’; 
this is useful when you want to look at the underlining which is present in an nroff output stream on a crt- 
terminal. 


SEE ALSO 


BUGS 


man(1), nroff(1), colert(1) 


Nroff usually outputs a series of backspaces and underlines intermixed with the text to indicate underlining. 
No attempt is made to optimize the backward motion. 
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NAME 


unifdef — remove ifdef’ed lines 


SYNOPSIS 


unifdef | -t -1-c -Dsym —Usym —idsym —-iusym ] ... [ file ] 


DESCRIPTION 


Unifdef is useful for removing ifdef’ed lines from a file while otherwise leaving the file alone. Unifdef is 
like a stripped-down C preprocessor: it is smart enough to deal with the nested ifdefs, comments, single and 
double quotes of C syntax so that it can do its job, but it doesn’t do any including or interpretation of mac- 
ros. Neither does it strip out comments, though it recognizes and ignores them. You specify which sym- 
bols you want defined —-Dsym or undefined —-Usym and the lines inside those ifdefs will be copied to the out- 
put or removed as appropriate. The ifdef, ifndef, else, and endif lines associated with sym will also be 
removed. Ifdefs involving symbols you don’t specify are untouched and copied out along with their associ- 
ated ifdef, else, and endif lines. If an ifdef X occurs nested inside another ifdef X, then the inside ifdef is 
treated as if it were an unrecognized symbol. If the same symbol appears in more than one argument, only 
the first occurrence is significant. 


The -I option causes unifdef to replace removed lines with blank lines instead of deleting them. 


If you use ifdefs to delimit non-C lines, such as comments or code which is under construction, then you 
must tell unifdef which symbols are used for that purpose so that it won’t try to parse for quotes and com- 
ments in those ifdefed lines. You specify that you want the lines inside certain ifdefs to be ignored but 
copied out with -idsym and —iusym similar to -Dsym and —Usym above. 


If you want to use unifdef for plain text (not C code), use the -t option. This makes unifdef refrain from 
attempting to recognize comments and single and double quotes. 


Unifdef copies its output to stdout and will take its input from stdin if no file argument is given. If the -c 
argument is specified, then the operation of unifdef is complemented, i.e. the lines that would have been 
removed or blanked are retained and vice versa. 


SEE ALSO 


diff(1) 


DIAGNOSTICS 


BUGS 


Premature EOF, inappropriate else or endif. 


Exit status is 0 if output is exact copy of input, | if not, 2 if trouble. 


Does not know how to deal with cpp consructs such as 


Hif defined(X) || defined(Y) 


AUTHOR 


Dave Yost 
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NAME 
uniq — report repeated lines in a file 


SYNOPSIS 
unigq [ -ude [ +n ] [—-n ] ] [ input [ output ] ] 

DESCRIPTION 
Unig reads the input file comparing adjacent lines. In the normal case, the second and succeeding copies of 
repeated lines are removed; the remainder is written on the output file. Note that repeated lines must be 
adjacent in order to be found; see sort(1). If the —u flag is used, just the lines that are not repeated in the 
original file are output. The —-d option specifies that one copy of just the repeated lines is to be written. The 
normal mode output is the union of the —u and -d mode outputs. 


The -c option supersedes —u and —d and generates an output report in default style but with each line pre- 
ceded by a count of the number of times it occurred. 


The n arguments specify skipping an initial portion of each line in the comparison: 


—n The first n fields together with any blanks before each are ignored. A field is defined as a string 
of non-space, non-tab characters separated by tabs and spaces from its neighbors. 
+n The first n characters are ignored. Fields are skipped before characters. 
SEE ALSO 


sort(1), comm(1) 
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NAME 


units — conversion program 


SYNOPSIS 


units 


DESCRIPTION 


FILES 


BUGS 


Units converts quantities expressed in various standard scales to their equivalents in other scales. It works 
interactively in this fashion: 


You have: inch 

You want: cm 
* 2.54000e +00 
/ 3.93701le-0l 


A quantity is specified as a multiplicative combination of units optionally preceded by a numeric multiplier. 
Powers are indicated by suffixed positive integers, division by the usual sign: 


You have: 15 pounds force/in2 
You want: atm 

* 1.02069e+00 

/ 9.79730e-01 


Units only does multiplicative scale changes. Thus it can convert Kelvin to Rankine, but not Centigrade to 
Fahrenheit. Most familiar units, abbreviations, and metric prefixes are recognized, together with a generous 
leavening of exotica and a few constants of nature including: 


pi ratio of circumference to diameter 
c speed of light 

e charge on an electron 

g acceleration of gravity 


force sameasg 

mole Avogadro’s number 

water pressure head per unit height of water 
au astronomical unit 


‘Pound’ is a unit of mass. Compound names are run together, e.g. ‘lightyear’. British units that differ from 
their US counterparts are prefixed thus: ‘brgallon’. Currency is denoted “belgiumfranc’, ‘britainpound’, ... 
For a complete list of units, ‘cat /usr/lib/units’. 


/usr/lib/units 


Don’t base your financial plans on the currency conversions. 
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NAME 
uptime — show how long system has been up 


SYNOPSIS 
uptime 


DESCRIPTION 
Uptime prints the current time, the length of time the system has been up, and the average number of jobs 
in the run queue over the last 1, 5 and 15 minutes. It is, essentially, the first line of a w(1) command. 


FILES 
/vmunix system name list 


SEE ALSO 
w(1) 
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NAME 
users — compact list of users who are on the system 


SYNOPSIS 
users 


DESCRIPTION 
Users lists the login names of the users currently on the system in a compact, one-line format. 


FILES 
/etc/utmp 


SEE ALSO 
who(1) 
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NAME 


uucp — unix to unix copy 


SYNOPSIS 


uucp [ —acCdfmr ] [ -nuser | [ -ggrade | [ -sspool | [ -xdebug | source-file.... destination-file 


DESCRIPTION 


FILES 


Uucp copies files named by the source-file arguments to the destination-file argument. A file name may be 
a pathname on your machine, or may have the form 


system-name!pathname 


where ‘system-name’ is taken from a list of system names that uucp knows about. Shell metacharacters 
?*[] appearing in the pathname part will be expanded on the appropriate system. 


Pathnames may be one of: 
(1) a full pathname; 


(2) a pathname preceded by “user; where user is a userid on the specified system and is replaced by 
that user’s login directory; 


(3) a pathname prefixed by ~, where ~ is expanded into the system’s public directory (usually 
/ustr/spool/uucppublic); 


(4) a partial pathname, which is prefixed by the current directory. 


If the result is an erroneous pathname for the remote system, the copy will fail. If the destination-file is a 
directory, the last part of the source-file name is used. 


Uucp preserves execute permissions across the transmission and gives 0666 read and write permissions (see 
chmod(2)). 


The following options are interpreted by uucp. 


-a Avoid doing a gefwd to find the current directory. (This is sometimes used for efficiency.) 

-c Use the source file when copying out rather than copying the file to the spool directory. (This is 
the default.) 

-C Copy the source file to the spool directory and transmit the copy. 


-d Make all necessary directories for the file copy. (This is the default.) 
-f Do not make intermediate directories for the file copy. 


—ggrade 
Grade is a single letter/number; lower ASCII sequence characters will cause a job to be transmit- 
ted earlier during a particular conversation. Default is ‘n’. By way of comparison, uux(1C) 
defaults to ‘A’; mail is usually sent at “C’. 


—m Send mail to the requester when the copy is complete. 

-nuser Notify user on remote system (i.e., send user mail) that a file was sent. 
-r Do not start the transfer, just queue the job. 

-sspool Use spool as the spool directory instead of the default. 


—xdebug 
Turn on the debugging at level debug. 


/usr/spool/uucp - spool directory 
/usr/lib/uucp/* - other data and program files 
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SEE ALSO 


uux(1C), mail(1) 
D. A. Nowitz and M. E. Lesk, A Dial-Up Network of UNIX Systems. 


D. A. Nowitz, Uucp Implementation Description. 


WARNING 


BUGS 


The domain of remotely accessible files can (and for obvious security reasons, usually should) be severely 
restricted. You will very likely not be able to fetch files by pathname; ask a responsible person on the 
remote system to send them to you. For the same reasons you will probably not be able to send files to 
arbitrary pathnames. 


All files received by uucp will be owned by the uucp administrator (usually UID 5). 


The —m option will only work sending files or receiving a single file. (Receiving multiple files specified by 
special shell characters ?*[] will not activate the -m option.) 


At present uucp cannot copy to a system several "hops" away, that is, a command of the form 
uucp myfile system1!system2!system3!yourfile 


is not permitted. Use uusend(1C) instead. 


op 


When invoking uucp from csh(1), the ‘!’ character must be prefixed by the ‘V escape to inhibit csh’s his- 
tory mechanism. (Quotes are not sufficient.) 


6eé 


Uucp refuses to copy a file that does not give read access to ‘‘other’’; that is, the file must have at least 


0444 modes. 
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NAME 


uuencode, uudecode — encode/decode a binary file for transmission via mail 


SYNOPSIS 


uuencode [ source ] remotedest | mail sysl!sys2!..!decode 
uudecode [ file | 


DESCRIPTION 


Uuencode and uudecode are used to send a binary file via uucp (or other) mail. This combination can be 
used over indirect mail links even when uusend(1C) is not available. 


Uuencode takes the named source file (default standard input) and produces an encoded version on the stan- 
dard output. The encoding uses only printing ASCII characters, and includes the mode of the file and the 
remotedest for recreation on the remote system. 


Uudecode reads an encoded file, strips off any leading and trailing lines added by mailers, and recreates the 
original file with the specified mode and name. 


The intent is that all mail to the user ‘“decode’’ should be filtered through the uudecode program. This way 
the file is created automatically without human intervention. This is possible on the uucp network by either 
using sendmail or by making rmail be a link to Mail instead of mail. In each case, an alias must be created 
in a master file to get the automatic invocation of uudecode. 


If these facilities are not available, the file can be sent to a user on the remote machine who can uudecode it 
manually. 


The encode file has an ordinary text form and can be edited by any text editor to change the mode or remote 
name. 


SEE ALSO 


BUGS 


atob(n), uusend(1C), uucp(1C), uux(1C), mail(1), uuencode(5) 


The file is expanded by 35% (3 bytes become 4 plus control information) causing it to take longer to trans- 
mit. 


The user on the remote system who is invoking uudecode (often uucp) must have write permission on the 
specified file. 
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NAME 

uulog — display UUCP log files 
SYNOPSIS 

uulog [ -s sys ] [-u user ] 
DESCRIPTION 


Uulog queries a log of uucp(1C) and uux(1C) transactions in the file /usr/spool/uucp/LOGFILE. 
The options command uulog to print logging information: 

—SSyS Print information about work involving system sys. 

—-uuser Print information about work done for the specified user. 


FILES 
/ust/spool/uucp/LOGFILE 


SEE ALSO 
uucp(1C), uux(1C). 


NOTES 
Very early releases of UUCP used separate log files for each of the UUCP utilities; uulog was used to merge 
the individual logs into a master file. This capability has not been necessary for some time and is no longer 
supported. 


BUGS 
UUCP’s recording of which user issued a request is unreliable. 


Uulog is little more than an overspecialized version of grep(1). 
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NAME 

uuname — list names of UUCP hosts 
SYNOPSIS 

uuname [ - | 
DESCRIPTION 


Uuname lists the UUCP names of known systems. The —] option returns the local system name; this may 
differ from the hostname(1) for the system if the hostname is very long. 


SEE ALSO 
uucp(1C), uux(1C). 
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NAME 
uuq — examine or manipulate the uucp queue 


SYNOPSIS 
uug [ -1 ] [ -h ] [ -ssystem ] [ -uuser | [ -djobno | [ -rsdir ] [ -bbaud | 


DESCRIPTION 
Uug is used to examine (and possibly delete) entries in the uucp queue. 


When listing jobs, wug uses a format reminiscent of /s. For the long format, information for each job listed 
includes job number, number of files to transfer, user who spooled the job, number of bytes to send, type of 
command requested (S for sending files, R for receiving files, X for remote uucp), and file or command 
desired. 


Several options are available: 


—-h Print only the summary lines for each system. Summary lines give system name, number of 
jobs for the system, and total number of bytes to send. 


-l Specifies a long format listing. The default is to list only the job numbers sorted across the 
page. 
-ssystem Limit output to jobs for systems whose system names begin with system. 


—uuser Limit output to jobs for users whose login names begin with user. 


-djobno Delete job number jobno (as obtained from a previous uug command) from the uucp queue. 
Only the UUCP Administrator is permitted to delete jobs. 


—rsdir Look for files in the spooling directory sdir instead of the default directory. 


—bbaud Use baud to compute the transfer time instead of the default 1200 baud. 


FILES 
/ustr/spool/uucp/ Default spool directory /usr/spool/uucp/C/C.* Control files 
/ust/spool/uucp/Dhostname./D.* Outgoing data files /usr/spool/uucp/X./X.* Outgoing execu- 
tion files 
SEE ALSO 
uucp(1C), uux(1C), uulog(1C), uusnap(8C) 
BUGS 
No information is available on work requested by the remote machine. 
The user who requests a remote uucp command is unknown. 
Uugq -1 can be horrendously slow. 
AUTHOR 


Lou Salkind, New York University 
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NAME 
uusend — send a file to a remote host 


SYNOPSIS 


uusend [ —m mode ] sourcefile sys1!sys2!..!remotefile 


DESCRIPTION 


Uusend sends a file to a given location on a remote system. The system need not be directly connected to 
the local system, but a chain of uucp(1) links needs to connect the two systems. 


If the —m option is specified, the mode of the file on the remote end will be taken from the octal number 
given. Otherwise, the mode of the input file will be used. 


The sourcefile can be ‘‘—’’, meaning to use the standard input. Both of these options are primarily intended 
for internal use of uusend. 


The remotefile can include the “userid syntax. 


DIAGNOSTICS 


If anything goes wrong any further away than the first system down the line, you will never hear about it. 


SEE ALSO 


BUGS 


uux(1), uucp(1), uuencode(1) 


This command should not exist, since uucp should handle it. 
All systems along the line must have the uuwsend command available and allow remote execution of it. 


Some uucp systems have a bug where binary files cannot be the input to a uux command. If this bug exists 
in any system along the line, the file will show up severly munged. 
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NAME 
uux — unix to unix command execution 


SYNOPSIS 
uux [ - | [ -cClLnprz ] [ -aname ] [ -ggrade | [ -xdebug | command-string 


DESCRIPTION 
Uux will gather zero or more files from various systems, execute a command on a specified system and then 
send standard output to a file on a specified system. 


The command-string is made up of one or more arguments that look like a Shell command line, except that 
the command and file names may be prefixed by system-name!. A null system-name is interpreted as the 
local system. 


File names may be one of 
(1) a full path name; 


(2) a path name preceded by “user where user is a login name on the specified system and is 
replaced by that user’s login directory; 


(3) a path name prefixed by ~; where ~ is expanded to the system’s public directory (usually 
/ust/spool/uucppublic); 


(4) a partial pathname, which is prefixed by the current directory. 
As an example, the command 
uux "!diff usg!/usr/dan/file1 pwba!/a4/dan/file2 > !"/dan/file. diff" 


will get the filel and file2 files from the ‘‘usg’’ and ‘‘pwba’’ machines, execute a diff(1) command and put 
the results in file.diff in the local /usr/spool/uucppublic/dan/ directory. 


Any special shell characters, such as <>3 |, should be quoted either by quoting the entire command-string, 
or quoting the special characters as individual arguments. 


Uux will attempt to get all files to the execution system. For files that are output files, the file name must be 
escaped using parentheses. For example, the command 


uux a!we b!/usr/filel \(c!/usr/file2 \) 


66,99 


get /usr/filel from system ‘‘b’’ and send it to system ‘‘a’’, perform a wc command on that file and send the 


6699 


result of the wc command to system ‘‘c’’. 


Uux will notify you by mail if the requested command on the remote system was disallowed. This 
notification can be turned off by the —n option. 


The following options are interpreted by uux: 
- The standard input to uux is made the standard input to the command-string. 


-aname Use name as the user identification replacing the initiator user-id. 


-c Do not copy local file to the spool directory for transfer to the remote machine (this is the default). 
-C Force the copy of local files to the spool directory for transfer. 
—ggrade 


Grade is a single letter/number, from 0 to 9, A to Z, or a to z; 0 is the highest, and z is the lowest 
grade. The default is A; by comparison uucp(1C) defaults to n and mail is usually sent at grade C. 
Lower grades should be specified for high-volume jobs, such as news. 


-l Try and make a link from the original file to the spool directory. If the link cannot be made, copy 
the file. 
—n Do not notify the user when the command completes. 
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-p Same as —: The standard input to uux is made the standard input to the command-string. 
-r Do not start the file transfer, just queue the job. 
—xdebug 


Produce debugging output on stdout. The debug is a number between 0 and 9; higher numbers 
give more detailed information. Debugging is permitted only for privileged users (specifically, 
those with read access to L.sys(5). 


-Z Notify the user only if the command fails. 
-L Start up uucico with the -L flag. This will force calls to be made to local sites only (see 
uucico(8C)). 
FILES 
/ustr/spool/uucp spool directories 
/usr/lib/uucp/* UUCP configuration data and daemons 
SEE ALSO 


uucp(1C), uucico(8C), uuxqt(8C). 


WARNING 


BUGS 


For security reasons, many installations will limit the list of commands executable on behalf of an incom- 
ing request from uux. Many sites will permit little more than the receipt of mail (see mail(1)) via uux. 


Only the first command of a shell pipeline may have a system-name!. All other commands are executed on 
the system of the first command. 


The use of the shell metacharacter * will probably not do what you want it to do. 
The shell tokens << and >> are not implemented. 


When invoking uux from csh(1), the *!’ character must be prefixed by the ‘\’ escape to inhibit csh’s history 
mechanism. (Quotes are not sufficient.) 
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NAME 
vacation — return “‘I am on vacation’’ indication 


SYNOPSIS 
vacation —-I 
vacation user 


DESCRIPTION 
Vacation returns a message to the sender of a message telling that you are on vacation. The intended use is 
in a .forward file. For example, your forward file might have: 


\eric, " | vacation eric" 


which would send messages to you (assuming your login name was eric) and send a message back to the 
sender. 


Vacation expects a file .vacation.msg in your home directory containing a message to be sent back to each 
sender. It should be an entire message (including headers). For example, it might say: 


From: eric@ucbmonet.Berkeley.EDU (Eric Allman) 
Subject: Iam on vacation 
Delivered-By-The-Graces-Of: the Vacation program 


Iam on vacation until July 22. If you have something urgent, 
please contact Joe Kalash <kalash@ucbingres.Berkeley.EDU>. 
--eric 


This message will only be sent once a week to each unique sender. The people who have sent you mes- 
sages are kept in the files .vacation.pag and .vacation.dir in your home directory. The -I option initializes 
these files, and should be executed before you modify your .forward file. 


If the -I flag is not specified, vacation reads the first line from the standard input for a UNIX-style ‘‘From’’ 
line to determine the sender. If this is not present, a nasty diagnostic is produced. Sendmail(8) includes the 
““From’’ line automatically. 


No message is sent if the initial “‘From’’ line includes the string ‘“‘“-REQUEST@”’ or if a ‘‘Precedence: 
bulk’’ or ‘‘Precedence: junk’’ line is included in the header. 


SEE ALSO 
sendmail(8) 
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NAME 


verind — grind nice listings of programs 


SYNOPSIS 


verind [-f][-][-t][-][-x ] [-W][-sn ] [ -h header ] [ -d file ] [ -Wanguage ] name ... 


DESCRIPTION 


Vgrind formats the program sources which are arguments in a nice style using troff(1) Comments are 
placed in italics, keywords in bold face, and the name of the current function is listed down the margin of 
each page as it is encountered. 


Vgrind runs in two basic modes, filter mode or regular mode. In filter mode vgrind acts as a filter in a man- 
ner similar to tb/(1). The standard input is passed directly to the standard output except for lines bracketed 
by the troff-like macros: 


LVS - starts processing 
.VE - ends processing 


These lines are formatted as described above. The output from this filter can be passed to troff for output. 
There need be no particular ordering with egn(1) or tb/(1). 


In regular mode vgrind accepts input files, processes them, and passes them to troff(1) for output. 
In both modes vgrind passes any lines beginning with a decimal point without conversion. 

The options are: 

-f forces filter mode 


- forces input to be taken from standard input (default if -f is specified ) 


-t similar to the same option in troff causing formatted text to go to the standard output 
—n forces no keyword bolding 
-x outputs the index file in a ‘‘pretty’’ format. The index file itself is produced whenever vgrind is 


run with a file called index in the current directory. The index of function definitions can then be 
run off by giving vgrind the -x option and the file index as argument. 


-W forces output to the (wide) Versatec printer rather than the (narrow) Varian 

-s specifies a point size to use on output (exactly the same as the argument of a .ps) 

-h specifies a particular header to put on every output page (default is the file name) 

-d specifies an alternate language definitions file (default is /usr/lib/vgrindefs) 

-l specifies the language to use. Currently known are PASCAL (-Ip), MODEL (-Im),C (-le or the 


default), CSH (-Iesh), SHELL (-Ish), RATFOR (-Ir), MODULA2 (-Imod2), YACC (-lyacc), 
ISP (-lisp), and ICON (-ID. 


FILES 
index file where source for index is created 
/usr/lib/tmac/tmac.vgrind macro package 
/usr/lib/vfontedpr preprocessor 
/usr/lib/vgrindefs language descriptions 
AUTHOR 


Dave Presotto & William Joy 


SEE ALSO 


vlp(1), vtroff(1), vgrindefs(5) 
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BUGS 
Vfontedpr assumes that a certain programming style is followed: 


For C — function names can be preceded on a line only by spaces, tabs, or an asterisk. The parenthesized 
arguments must also be on the same line. 


For PASCAL - function names need to appear on the same line as the keywords function or procedure. 
For MODEL - function names need to appear on the same line as the keywords is beginproc. 


If these conventions are not followed, the indexing and marginal function name comment mechanisms will 
fail. 


More generally, arbitrary formatting styles for programs mostly look bad. The use of spaces to align source 
code fails miserably; if you plan to vgrind your program you should use tabs. This is somewhat inevitable 
since the font used by vgrind is variable width. 


The mechanism of ctags in recognizing functions should be used here. 


Filter mode does not work in documents using the —-me or —ms macros. (So what use is it anyway?) 
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NAME 
vi — screen oriented (visual) display editor based on ex 
SYNOPSIS 
vi [ -t tag ] [-r ] [ +command ] [-1] [—wn ] name ... 
DESCRIPTION 
Vi (visual) is a display oriented text editor based on ex(1). Ex and vi run the same code; it is possible to get 
to the command mode of ex from within vi and vice-versa. 
The Vi Quick Reference card and the Introduction to Display Editing with Vi provide full details on using 
Vi. 
FILES 
See ex(1). 
SEE ALSO 
ex (1), edit (1), “Vi Quick Reference’ card, ‘‘An Introduction to Display Editing with Vi’’. 
AUTHOR 
William Joy 
Mark Horton added macros to visual mode and is maintaining version 3 
BUGS 


Software tabs using “T work only immediately after the autoindent. 


Left and right shifts on intelligent terminals don’t make use of insert and delete character operations in the 
terminal. 


The wrapmargin option can be fooled since it looks at output columns when blanks are typed. If a long 
word passes through the margin and onto the next line without a break, then the line won’t be broken. 


Insert/delete within a line can be slow if tabs are present on intelligent terminals, since the terminals need 
help in doing this correctly. 


Saving text on deletes in the named buffers is somewhat inefficient. 


The source command does not work when executed as :source; there is no way to use the :append, 
:change, and :insert commands, since it is not possible to give more than one line of input to a : escape. 
To use these on a :global you must Q to ex command mode, execute them, and then reenter the screen edi- 
tor with vi or open. 
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vlp — Format Lisp programs to be printed with nroff, vtroff, or troff 


SYNOPSIS 


vip [ -p pointsize }{ <A] [£1] [1] [-v] [1 title/ ] filel [ -T title2 ] file2 ... 


DESCRIPTION 


Vip formats the named files so that they can be run through nroff, vtroff, or troff to produce listings that 
line-up and are attractive. The first non-blank character of each line is lined-up vertically, as in the source 
file. Comments (text beginning with a semicolon) are printed in italics. Each function’s name is printed in 
bold face next to the function. This format makes Lisp code look attractive when it is printed with a vari- 
able width font. 


Normally, vip works as a filter and sends its output to the standard output. However, the —v switch pipes 
the output directly to vtroff. If no files are specified, then v/p reads from the standard input. 


The following options are available: 


-p The —p switch changes the size of the text from its default value of 8 points to one of 6, 8, 10, or 
12 points. Once set, the point size is used for all subsequent files. This point size does not apply 
to embedded text (see —f below). 

-d The —d switch puts vip into debugging mode. 

-f Vip has a filtered mode in which all lines are passed unmodified, except those lines between the 
directives .Ls and .Le. This mode can be used to format Lisp code that is embedded in a docu- 
ment. The directive .Ls takes an optional argument that gives the point size for the embedded 
code. If not size is specified, the size of the surrounding text is used. 

-l The —I switch prevents v/p from placing labels next to functions. This switch is useful for embed- 
ded Lisp code, where the labels would be distracting. 

-v This switch cause vip to send its output to vtroff rather than the standard output. 

-T A title to be printed on each page may be specified by using the -T switch. The -T switch applies 
only to the next file name given. Titles are not printed for embedded text (see -f, above). This 
switch may not be used if v/p is reading from the standard input. 

FILES 
/usr/lib/vlpmacs troff/nroff macros 
AUTHOR 


Originally written by John K. Foderaro, with additional changes by Kevin Layer and James Larus. 


SEE ALSO 


verind(1), lisp(1) 


BUGS 


vip transforms \ into \\ so that it will be printed out. Hence, troff commands cannot be embedded in Lisp 


code. 
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NAME 

vmstat — report virtual memory statistics 
SYNOPSIS 

vmstat [ —-fsi | [ drives ] [ interval [ count ] ] 
DESCRIPTION 


Vmstat delves into the system and normally reports certain statistics kept about process, virtual memory, 
disk, trap and cpu activity. If given a -f argument, it instead reports on the number of forks and vforks 
since system startup and the number of pages of virtual memory involved in each kind of fork. If given a 
—s argument, it instead prints the contents of the sum structure, giving the total number of several kinds of 
paging related events which have occurred since boot. If given a -i argument, it instead reports on the 
number of interrupts taken by each device since system startup. 


If none of these options are given, vmstat will report in the first line a summary of the virtual memory activ- 
ity since the system has been booted. If interval is specified, then successive lines are summaries over the 
last interval seconds. ‘‘vmstat 5’’ will print what the system is doing every five seconds; this is a good 
choice of printing interval since this is how often some of the statistics are sampled in the system; others 
vary every second, running the output for a while will make it apparent which are recomputed every sec- 
ond. If a count is given, the statistics are repeated count times. The format fields are: 


Procs: information about numbers of processes in various states. 


rt in run queue 
b blocked for resources (i/o, paging, etc.) 
w runnable or short sleeper (< 20 secs) but swapped 


Memory: information about the usage of virtual and real memory. Virtual pages are considered active if 
they belong to processes which are running or have run in the last 20 seconds. A ‘‘page’’ here is 1024 


bytes. 
avm active virtual pages 
fre size of the free list 


Page: information about page faults and paging activity. These are averaged each five seconds, and given 
in units per second. 


re page reclaims (simulating reference bits) 

at pages attached (found in free list) 

pi pages paged in 

po pages paged out 

fr pages freed per second 

de anticipated short term memory shortfall 

st pages scanned by clock algorithm, per-second 


up/hp/rk/ra: Disk operations per second (this field is system dependent). Typically paging will be split 
across several of the available drives. The number under each of these is the unit number. 


Faults: trap/interrupt rate averages per second over last 5 seconds. 


in (non clock) device interrupts per second 
sy system calls per second 
cs cpu context switch rate (switches/sec) 


Cpu: breakdown of percentage usage of CPU time 


us user time for normal and low priority processes 
sy system time 
id cpu idle 
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If more than 4 disk drives are configured in the system, vmstat displays only the first 4 drives, with priority 
given to Massbus disk drives (i.e. if both Unibus and Massbus drives are present and the total number of 
drives exceeds 4, then some number of Unibus drives will not be displayed in favor of the Massbus drives). 
To force vmstat to display specific drives, their names may be supplied on the command line. 


FILES 
/dev/kmem, /vmunix 


SEE ALSO 
systat(1), iostat(1) 


The sections starting with “‘Interpreting system activity’’ in Installing and Operating 4.2bsd. 
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NAME 


vwidth — make troff width table for a font 


SYNOPSIS 


vwidth fontfile pointsize > ftxx.c 
ce -c ftxx.c mv ftxx.0 /usr/lib/font/ftxx 


DESCRIPTION 


Vwidth translates from the width information stored in the vfont style format to the format expected by 
troff. Troff wants an object file in a.out(S) format. (This fact does not seem to be documented anywhere.) 
Troff should look directly in the font file but it doesn’t. 


Vwidth should be used after editing a font with fed(1). It is not necessary to use vwidth unless you have 
made a change that would affect the width tables. Such changes include numerically editing the width 
field, adding a new character, and moving or copying a character to a new position. It is not always neces- 
sary to use vwidth if the physical width of the glyph (e.g. the number of columns in the bit matrix) has 
changed, but if it has changed much the logical width should probably be changed and vwidth run. 


Vwidth produces a C program on its standard output. This program should be run through the C compiler 
and the object (that is, the .o file) saved. The resulting file should be placed in /usr/lib/font in the file ftxx 
where is a one or two letter code that is the logical (internal to troff) font name. This name can be found by 
looking in the file /usr/lib/fontinfo/fname * where fname is the external name of the font. 


SEE ALSO 


BUGS 


fed(1), vfont(5), troff(1), vtroff(1) 


Produces the C file using obsolete syntax that the portable C compiler complains about. 


4.2 Berkeley Distribution April 29, 1985 1 


W(1) UNIX Programmer’s Manual W(1) 
NAME 
w — who is on and what they are doing 
SYNOPSIS 
w [-h ][-s ] [ user ] 
DESCRIPTION 
W prints a summary of the current activity on the system, including what each user is doing. The heading 
line shows the current time of day, how long the system has been up, the number of users logged into the 
system, and the load averages. The load average numbers give the number of jobs in the run queue aver- 
aged over 1, 5 and 15 minutes. 
The fields output are: the users login name, the name of the tty the user is on, the time of day the user 
logged on, the number of minutes since the user last typed anything, the CPU time used by all processes 
and their children on that terminal, the CPU time used by the currently active processes, the name and argu- 
ments of the current process. 
The —h flag suppresses the heading. The -s flag asks for a short form of output. In the short form, the tty is 
abbreviated, the login time and cpu times are left off, as are the arguments to commands. -l gives the long 
output, which is the default. 
If a user name is included, the output will be restricted to that user. 
FILES 
/etc/utmp 
/dev/kmem 
/dev/drum 
SEE ALSO 
who(1), finger(1), ps(1) 
AUTHOR 
Mark Horton 
BUGS 


The notion of the ‘‘current process’’ is muddy. The current algorithm is ‘‘the highest numbered process on 
the terminal that is not ignoring interrupts, or, if there is none, the highest numbered process on the termi- 
nal’’. This fails, for example, in critical sections of programs like the shell and editor, or when faulty pro- 
grams running in the background fork and fail to ignore interrupts. (In cases where no process can be 
found, w prints ‘‘—’’.) 

The CPU time is only an estimate, in particular, if someone leaves a background process running after log- 
ging out, the person currently on that terminal is ‘‘charged’’ with the time. 


Background processes are not shown, even though they account for much of the load on the system. 


Sometimes processes, typically those in the background, are printed with null or garbaged arguments. In 
these cases, the name of the command is printed in parentheses. 


W does not know about the new conventions for detection of background jobs. It will sometimes find a 
background job instead of the right one. 
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NAME 
wait — await completion of process 


SYNOPSIS 
wait 
DESCRIPTION 


Wait until all processes started with & have completed, and report on abnormal terminations. 


Because the wait(2) system call must be executed in the parent process, the Shell itself executes wait, with- 
out creating a new process. 


SEE ALSO 
sh(1) 


BUGS 
Not all the processes of a 3- or more-stage pipeline are children of the Shell, and thus can’t be waited for. 
(This bug does not apply to csh(1).) 
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NAME 
wall — write to all users 


SYNOPSIS 
wall 


DESCRIPTION 
Wall reads its standard input until an end-of-file. It then sends this message, preceded by ‘Broadcast Mes- 
sage ...’, to all logged in users. 


The sender should be super-user to override any protections the users may have invoked. 


FILES 
/dev/tty? 
/etc/utmp 
SEE ALSO 


mesg(1), write(1) 


DIAGNOSTICS 
‘Cannot send to ...” when the open on a user’s tty file fails. 
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NAME 
we — word count 


SYNOPSIS 
we [-Iwe | [ name... ] 


DESCRIPTION 
Wc counts lines, words and characters in the named files, or in the standard input if no name appears. A 


word is a maximal string of characters delimited by spaces, tabs or newlines. 


If an argument beginning with one of ‘‘lwc’’ is present, the specified counts (lines, words, or characters) are 
selected by the letters 1, w, or c. The default is -Iwe. 


BUGS 
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NAME 
what — show what versions of object modules were used to construct a file 


SYNOPSIS 
what name ... 

DESCRIPTION 
What reads each file and searches for sequences of the form “‘@(#)’’ as inserted by the source code control 
system. It then prints the remainder of the string after this marker, up to a null character, newline, double 
quote, or ‘*>’’ character. 


BUGS 
As SCCS is not licensed with UNIX/32V, this is a rewrite of the what command which is part of SCCS, 


and may not behave exactly the same as that command does. 


4th Berkeley Distribution April 29, 1985 1 


WHATIS (1) UNIX Programmer’s Manual WHATIS (1) 


NAME 

whatis — describe what a command is 
SYNOPSIS 

whatis command ... 
DESCRIPTION 


Whatis looks up a given command and gives the header line from the manual section. You can then run the 
man(1) command to get more information. If the line starts ‘name(section) ...’ you can do “man section 
name’ to get the documentation for it. Try ‘whatis ed’ and then you should do ‘man | ed’ to get the man- 
ual. 


Whatis is actually just the -f option to the man(1) command. 


FILES 
/usr/man/whatis Data base 


SEE ALSO 
man(1), catman(8) 
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NAME 


whereis — locate source, binary, and or manual for program 


SYNOPSIS 


whereis [ —sbm ] [ —u | [—SBM dir ... -f ] name ... 


DESCRIPTION 


Whereis locates source/binary and manuals sections for specified files. The supplied names are first 
stripped of leading pathname components and any (single) trailing extension of the form ‘‘.ext’’, e.g. “‘.c’’ 
Prefixes of ‘‘s.’’ resulting from use of source code control are also dealt with. Whereis then attempts to 
locate the desired program in a list of standard places. If any of the —b, -s or —-m flags are given then 
whereis searches only for binaries, sources or manual sections respectively (or any two thereof). The —u 
flag may be used to search for unusual entries. A file is said to be unusual if it does not have one entry of 
each requested type. Thus ‘‘whereis -m -u *’’ asks for those files in the current directory which have no 
documentation. 


Finally, the -B -M and -S flags may be used to change or otherwise limit the places where whereis 
searches. The -f file flags is used to terminate the last such directory list and signal the start of file names. 


EXAMPLE 


FILES 


BUGS 


The following finds all the files in /usr/bin which are not documented in /usr/man/man1 with source in 
/ust/src/cmd: 


cd /usr/ucb 
whereis —u —M /usr/man/man1 —S /usr/src/emd —f * 


/usr/src/* 
/ustr/{doc,man }/* 
/lib, /etc, /usr/{lib,bin,ucb,old,new,local } 


Since the program uses chdir(2) to run faster, pathnames given with the -M —-S and -B must be full; ie. 
they must begin with a ‘‘/’’. 
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NAME 
which — locate a program file including aliases and paths (csh only) 


SYNOPSIS 
which [ name ] ... 


DESCRIPTION 
Which takes a list of names and looks for the files which would be executed had these names been given as 
commands. Each argument is expanded if it is aliased, and searched for along the user’s path. Both aliases 
and path are taken from the user’s .cshre file. 


FILES 
“/.cshre source of aliases and path values 

DIAGNOSTICS 
A diagnostic is given for names which are aliased to more than a single word, or if an executable file with 
the argument name was not found in the path. 

BUGS 


Must be executed by a csh, since only csh’s know about aliases. 
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NAME 
who — who is on the system 


SYNOPSIS 
who [ who-file ] [ am I ] 


DESCRIPTION 
Who, without an argument, lists the login name, terminal name, and login time for each current UNIX user. 


Without an argument, who examines the /etc/utmp file to obtain its information. Ifa file is given, that file is 
examined. Typically the given file will be /usr/adm/wtmp, which contains a record of all the logins since it 
was created. Then who lists logins, logouts, and crashes since the creation of the wtmp file. Each login is 
listed with user name, terminal name (with ‘/dev/’ suppressed), and date and time. When an argument is 
given, logouts produce a similar line without a user name. Reboots produce a line with ‘x’ in the place of 
the device name, and a fossil time indicative of when the system went down. 


With two arguments, as in ‘who am I’ (and also ‘who are you’), who tells who you are logged in as. 


FILES 
/etc/utmp 


SEE ALSO 
getuid(2), utmp(5) 
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NAME 
whoami — print effective current user id 
SYNOPSIS 
whoami 
DESCRIPTION 
Whoami prints who you are. It works even if you are su’d, while ‘who am i’ does not since it uses 
/etc/utmp. 
FILES 
/etc/passwd Name data base 
SEE ALSO 
who (1) 
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NAME 


whois — DARPA Internet user name directory service 


SYNOPSIS 


whois name 


DESCRIPTION 


whois help 
Produces a helpful message similar to the following: 


Please enter a name or a handle (‘‘ident"), such as “‘Smith" or “‘SRI-NIC". Starting with a period forces a 
name-only search; starting with exclamation point forces handle-only. Examples: 


Smith [looks for name or handle SMITH _  ] 
!SRI-NIC [looks for handle SRI-NIC only ] 
Smith, John [looks for name JOHN SMITH only ] 


Adding ‘*..." to the argument will match anything from that point, e.g. ““ZU..." will match ZUL, ZUM, etc. 


To have the ENTIRE membership list of a group or organization, if you are asking about a group or org, 
shown with the record, use an asterisk character “*’ directly preceding the given argument. [CAUTION: If 
there are a lot of members this will take a long time!] You may of course use exclamation point and aster- 
isk, or a period and asterisk together. 


SEE ALSO 


RFC 812: Nicname/Whois 


4.3 Berkeley Distribution June 6, 1985 1 


WINDOW (1) UNIX Programmer’s Manual WINDOW (1 ) 


NAME 

window — window environment 
SYNOPSIS 

window [ -t ] [ -f ] [-d ] [-e escape-char |] [ -c command |] 
DESCRIPTION 


Window implements a window environment on ASCII terminals. 


A window is a rectangular portion of the physical terminal screen associated with a set of processes. Its 
size and position can be changed by the user at any time. Processes communicate with their window in the 
same way they normally interact with a terminal--through their standard input, output, and diagnostic file 
descriptors. The window program handles the details of redirecting input an output to and from the win- 
dows. At any one time, only one window can receive input from the keyboard, but all windows can simul- 
taneously send output to the display. 


Windows can overlap and are framed as necessary. Each window is named by one of the digits “‘1’’ to 
“*Q’’. This one character identifier, as well as a user definable label string, are displayed with the window 
on the top edge of its frame. A window can be designated to be in the foreground, in which case it will 
always be on top of all normal, non-foreground windows, and can be covered only by other foreground 
windows. A window need not be completely within the edges of the terminal screen. Thus a large window 
(possibly larger than the screen) may be positioned to show only a portion of its full size. 


Each window has a cursor and a set of control functions. Most intelligent terminal operations such as line 
and character deletion and insertion are supported. Display modes such as underlining and reverse video 
are available if they are supported by the terminal. In addition, similar to terminals with multiple pages of 
memory, each window has a text buffer which can have more lines than the window itself. 


OPTIONS 
When window starts up, the commands (see long commands below) contained in the file .windowrc in the 
user’s home directory are executed. If it does not exist, two equal sized windows spanning the terminal 
screen are created by default. 


The command line options are 


-t Turn on terse mode (see terse command below). 
-f Fast. Don’t perform any startup action. 
-d Ignore .windowrc and create the two default windows instead. 


—e escape-char 
Set the escape character to escape-char. Escape-char can be a single character, or in the form “XK 
where X is any character, meaning control-X. 


-c command 
Execute the string command as a long command (see below) before doing anything else. 


PROCESS ENVIRONMENT 

With each newly created window, a shell program is spawned with its process environment tailored to that 
window. Its standard input, output, and diagnostic file descriptors are bound to one end of either a pseudo- 
terminal (pty (4)) or a UNIX domain socket (socketpair (4)). If a pseudo-terminal is used, then its special 
characters and modes (see stty (1)) are copied from the physical terminal. A termcap (5) entry tailored to 
this window is created and passed as environment (environ (5)) variable TERMCAP. The termcap entry 
contains the window’s size and characteristics as well as information from the physical terminal, such as 
the existence of underline, reverse video, and other display modes, and the codes produced by the 
terminal’s function keys, if any. In addition, the window size attributes of the pseudo-terminal are set to 
reflect the size of this window, and updated whenever it is changed by the user. In particular, the editor vi 
(1) uses this information to redraw its display. 


4.3 Berkeley Distribution May 12, 1986 1 


WINDOW (1) UNIX Programmer’s Manual WINDOW (1 ) 


OPERATION 
During normal execution, window can be in one of two states: conversation mode and command mode. In 
conversation mode, the terminal’s real cursor is placed at the cursor position of a particular window--called 
the current window--and input from the keyboard is sent to the process in that window. The current win- 
dow is always on top of all other windows, except those in foreground. In addition, it is set apart by high- 
lighting its identifier and label in reverse video. 


Typing window’s escape character (normally “P) in conversation mode switches it into command mode. In 
command mode, the top line of the terminal screen becomes the command prompt window, and window 
interprets input from the keyboard as commands to manipulate windows. 

There are two types of commands: short commands are usually one or two key strokes; long commands are 


strings either typed by the user in the command window (see the ‘‘:’? command below), or read from a file 
(see source below). 


SHORT COMMANDS 
Below, # represents one of the digits “‘1’’ to ‘*9’’ corresponding to the windows | to 9. “X means control- 
X, where X is any character. In particular, “is control-*. Escape is the escape key, or 7f. 


# Select window # as the current window and return to conversation mode. 


ot Select window # but stay in command mode. 


AAR 


Select the previous window and return to conversation mode. This is useful for toggling between 
two windows. 


escape Return to conversation mode. 


“Pp Return to conversation mode and write *P to the current window. Thus, typing two “P’s in conver- 
sation mode sends one to the current window. If the window escape is changed to some other 
character, that character takes the place of “P here. 


ey List a short summary of commands. 

“L Redraw the screen. 

q Exit window. Confirmation is requested. 

‘Z Suspend window. 

w Create a new window. The user is prompted for the positions of the upper left and lower right cor- 


ners of the window. The cursor is placed on the screen and the keys ‘‘h’’, ‘‘j’’, ‘*k’’, and “‘1’”’ 
move the cursor left, down, up, and right, respectively. The keys ‘‘H’’, ‘‘J’’, “‘K’’, and ‘‘L”’ 
move the cursor to the respective limits of the screen. Typing a number before the movement keys 
repeats the movement that number of times. Return enters the cursor position as the upper left cor- 
ner of the window. The lower right corner is entered in the same manner. During this process, the 
placement of the new window is indicated by a rectangular box drawn on the screen, correspond- 
ing to where the new window will be framed. Typing escape at any point cancels this command. 


This window becomes the current window, and is given the first available ID. The default buffer 
size is used (see nline command below). 


Only fully visible windows can be created this way. 


c# Close window #. The process in the window is sent the hangup signal (see kill (1)). Csh (1) 
should handle this signal correctly and cause no problems. 


mi# Move window # to another location. A box in the shape of the window is drawn on the screen to 
indicate the new position of the window, and the same keys as those for the w command are used 
to position the box. The window can be moved partially off-screen. 


M# Move window # to its previous position. 
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s# Change the size of window #. The user is prompted to enter the new lower right corner of the win- 
dow. A box is drawn to indicate the new window size. The same keys used in w and m are used 
to enter the position. 


S# Change window # to its previous size. 
“Y Scroll the current window up by one line. 
“E Scroll the current window down by one line. 
‘U Scroll the current window up by half the window size. 
“‘D Scroll the current window down by half the window size. 
“B Scroll the current window up by the full window size. 
“F Scroll the current window down by the full window size. 
h Move the cursor of the current window left by one column. 
j Move the cursor of the current window down by one line. 
k Move the cursor of the current window up by one line. 
] Move the cursor of the current window right by one column. 
‘Ss Stop output in the current window. 
*Q Start output in the current window. 
: Enter a line to be executed as long commands. Normal line editing characters (erase character, 
erase word, erase line) are supported. 
LONG COMMANDS 


Long commands are a sequence of statements parsed much like a programming language, with a syntax 
similar to that of C. Numeric and string expressions and variables are supported, as well as conditional 
statements. 


There are two data types: string and number. A string is a sequence of letters or digits beginning with a let- 
ter. ‘* ’’ and ‘‘.’’ are considered letters. Alternately, non-alphanumeric characters can be included in 
strings by quoting them in ‘‘"’’ or escaping them with ‘‘\’’. In addition, the ‘‘\’’ sequences of C are sup- 
ported, both inside and outside quotes (e.g., “‘\n’’ is a new line, “‘\r’’ a carriage return). For example, these 
are legal strings: abcde01234, "&#$**&#", ab" $#'"cd, ab\$\#ed, "/usr/ucb/window". 


A number is an integer value in one of three forms: a decimal number, an octal number preceded by ‘‘0’’, 
or a hexadecimal number preceded by ‘‘Ox’’ or ‘‘OX’’. The natural machine integer size is used (i.e., the 
signed integer type of the C compiler). As in C, a non-zero number represents a boolean true. 


The character ‘‘#’’ begins a comment which terminates at the end of the line. 


A statement is either a conditional or an expression. Expression statements are terminated with a new line 


66499 


or “‘;’’. To continue an expression on the next line, terminate the first line with ‘‘\’’. 


CONDITIONAL STATEMENT 
Window has a single control structure: the fully bracketed if statement in the form 
if <expr> then 
<statement> 


elsif <expr> then 
<statement> 


else 
<statement> 
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endif 
The else and elsif parts are optional, and the latter can be repeated any number of times. <Expr> must be 
numeric. 


EXPRESSIONS 
Expressions in window are similar to those in the C language, with most C operators supported on numeric 
operands. In addition, some are overloaded to operate on strings. 


When an expression is used as a statement, its value is discarded after evaluation. Therefore, only expres- 
sions with side effects (assignments and function calls) are useful as statements. 


Single valued (no arrays) variables are supported, of both numeric and string values. Some variables are 
predefined. They are listed below. 


The operators in order of increasing precedence: 


<expr1> = <expr2> 
Assignment. The variable of name <expr/>, which must be string valued, is assigned the result of 
<expr2>. Returns the value of <expr2>. 


<expr1> ? <expr2> : <expr3> 
Returns the value of <expr2> if <expr1> evaluates true (non-zero numeric value); returns the value 
of <expr3> otherwise. Only one of <expr2> and <expr3> is evaluated. <Expr/> must be numeric. 


<expr1> | | <expr2> 
Logical or. Numeric values only. Short circuit evaluation is supported (i.e., if <expr/> evaluates 
true, then <expr2> is not evaluated). 


<expr1> && <expr2> 
Logical and with short circuit evaluation. Numeric values only. 


<expr1> | <expr2> 
Bitwise or. Numeric values only. 


<expr1> * <expr2> 
Bitwise exclusive or. Numeric values only. 


<exprl> & <expr2> 
Bitwise and. Numeric values only. 


<expr1> == <expr2>, <expr1> != <expr2> 
Comparison (equal and not equal, respectively). The boolean result (either 1 or 0) of the compari- 
son is returned. The operands can be numeric or string valued. One string operand forces the 
other to be converted to a string in necessary. 


<expr1> < <expr2>, <expr1> > <expr2>, 
Less than, greater than, less than or equal to, greater than or equal to. Both numeric and string val- 
ues, with automatic conversion as above. 


<expr1> << <expr2>, <expr1> >> <expr2> 
If both operands are numbers, <expr/> is bit shifted left (or right) by <expr2> bits. If <expr/>is a 
string, then its first (or last) <expr2> characters are returns (if <expr2> is also a string, then its 
length is used in place of its value). 


<expr1> + <expr2>, <expr1> - <expr2> 
Addition and subtraction on numbers. For ‘‘+’’, if one argument is a string, then the other is con- 
verted to a string, and the result is the concatenation of the two strings. 


<exprl> * <expr2>, <expr1> / <expr2>, 
Multiplication, division, modulo. Numbers only. 


-<expr>, “<expr>, !<expr>, $<expr>, $?<expr> 
The first three are unary minus, bitwise complement and logical complement on numbers only. 
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The operator, ‘‘$’’, takes <expr> and returns the value of the variable of that name. If <expr> is 
numeric with value n and it appears within an alias macro (see below), then it refers to the nth 
argument of the alias invocation. ‘‘$?’’ tests for the existence of the variable <expr>, and returns 
1 if it exists or O otherwise. 


<expr>(<arglist>) 

Function call. <Expr> must be a string that is the unique prefix of the name of a builtin window 
function or the full name of a user defined alias macro. In the case of a builtin function, <arglist> 
can be in one of two forms: 

<exprl>, <expr2>,... 

argnamel = <expr1>, argname2 = <expr2>,... 
The two forms can in fact be intermixed, but the result is unpredictable. Most arguments can be 
omitted; default values will be supplied for them. The argnames can be unique prefixes of the the 
argument names. The commas separating arguments are used only to disambiguate, and can usu- 
ally be omitted. 


Only the first argument form is valid for user defined aliases. Aliases are defined using the alias 
builtin function (see below). Arguments are accessed via a variant of the variable mechanism (see 
‘*$’” operator above). 


Most functions return value, but some are used for side effect only and so must be used as state- 
ments. When a function or an alias is used as a statement, the parenthesis surrounding the argu- 
ment list may be omitted. Aliases return no value. 


BUILTIN FUNCTIONS 
The arguments are listed by name in their natural order. Optional arguments are in square brackets (“‘[ ]’’). 
Arguments that have no names are in angle brackets (““<>’’). 


alias((<string>], [<string-list>]) 
If no argument is given, all currently defined alias macros are listed. Otherwise, <string> is 
defined as an alias, with expansion <string-list>. The previous definition of <string>, if any, is 
returned. Default for <string-list> is no change. 


close(<window-list>) 
Close the windows specified in <window-list>. If <window-list> is the word all, than all windows 
are closed. No value is returned. 


cursormodes([modes]) 
Set the window cursor to modes. Modes is the bitwise or of the mode bits defined as the variables 
m_ul (underline), m_rev (reverse video), m_bik (blinking), and m_grp (graphics, terminal depen- 
dent). Return value is the previous modes. Default is no change. For example, 
cursor($m_rev| $m_blk) sets the window cursors to blinking reverse video. 


echo([window], [<string-list>]) 
Write the list of strings, <string-list>, to window, separated by spaces and terminated with a new 
line. The strings are only displayed in the window, the processes in the window are not involved 
(see write below). No value is returned. Default is the current window. 


escape([escapec]) 
Set the escape character to escape-char. Returns the old escape character as a one character string. 
Default is no change. Escapec can be a string of a single character, or in the form *X, meaning 
control-X. 


foreground([window], [flag]) 
Move window in or out of foreground. Flag can be one of on, off, yes, no, true, or false, with 
obvious meanings, or it can be a numeric expression, in which case a non-zero value is true. 
Returns the old foreground flag as a number. Default for window is the current window, default 
for flag is no change. 
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label([ window], [label]) 
Set the label of window to label. Returns the old label as a string. Default for window is the cur- 
rent window, default for /Jabel is no change. To turn off a label, set it to an empty string (""). 


list) No arguments. List the identifiers and labels of all windows. No value is returned. 


nline({nline]) 
Set the default buffer size to nline. Initially, it is 48 lines. Returns the old default buffer size. 
Default is no change. Using a very large buffer can slow the program down considerably. 


select([window]) 
Make window the current window. The previous current window is returned. Default is no 
change. 


shell((<string-list>]) 
Set the default window shell program to <string-list>. Returns the first string in the old shell set- 
ting. Default is no change. Initially, the default shell is taken from the environment variable 
SHELL. 


source(filename) 
Read and execute the long commands in filename. Returns -1 if the file cannot be read, 0 other- 
wise. 


terse((flag]) 
Set terse mode to flag. In terse mode, the command window stays hidden even in command mode, 
and errors are reported by sounding the terminal’s bell. Flag can take on the same values as in 
foreground above. Returns the old terse flag. Default is no change. 


unalias(alias) 
Undefine alias. Returns -1 if alias does not exist, 0 otherwise. 


unset(variable) 
Undefine variable. Returns -1 if variable does not exist, 0 otherwise. 


variables() 
No arguments. List all variables. No value is returned. 


window([row], [column], [nrow], [ncol], [nline], [frame], 

[pty], [mapnl], [shell]) 

Open a window with upper left corner at row, column and size nrow, ncol. If nline is specified, 
then that many lines are allocated for the text buffer. Otherwise, the default buffer size is used. 
Default values for row, column, nrow, and ncol are, respectively, the upper, left-most, lower, or 
right-most extremes of the screen. Frame, pty, and mapnil are flag values interpreted in the same 
way as the argument to foreground (see above); they mean, respectively, put a frame around this 
window (default true), allocate pseudo-terminal for this window rather than socketpair (default 
true), and map new line characters in this window to carriage return and line feed (default true if 
socketpair is used, false otherwise). Shell is a list of strings that will be used as the shell program 
to place in the window (default is the program specified by shell, see below). The created 
window’ identifier is returned as a number. 


write([window], [<string-list>]) 
Send the list of strings, <string-list>, to window, separated by spaces but not terminated with a 
new line. The strings are actually given to the window as input. No value is returned. Default is 
the current window. 


PREDEFINED VARIABLES 
These variables are for information only. Redefining them does not affect the internal operation of window. 


baud The baud rate as a number between 50 and 38400. 
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modes 


m_blk 
m_grp 
m_rev 
m_ul 
ncol 
nrow 


term 


FILES 
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The display modes (reverse video, underline, blinking, graphics) supported by the physical termi- 
nal. The value of modes is the bitwise or of some of the one bit values, m_blk, m_grp, m_rev, and 
m_ul (see below). These values are useful in setting the window cursors’ modes (see cursormodes 
above). 


The blinking mode bit. 

The graphics mode bit (not very useful). 

The reverse video mode bit. 

The underline mode bit. 

The number of columns on the physical screen. 
The number of rows on the physical screen. 


The terminal type. The standard name, found in the second name field of the terminal’s TERM- 
CAP entry, is used. 


~/.windowrce startup command file. 
/dev/[pt]ty[pq]? pseudo-terminal devices. 


DIAGNOSTICS 


Should be self explanatory. 


BUGS 
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NAME 
write — write to another user 

SYNOPSIS 
write user [ ttyname ] 

DESCRIPTION 
Write copies lines from your terminal to that of another user. When first called, it sends the message 

Message from yourname@yoursystem on yourttyname at time... 

The recipient of the message should write back at this point. Communication continues until an end of file 
is read from the terminal or an interrupt is sent. At that point write writes “EOT’ on the other terminal and 
exits. 
If you want to write to a user who is logged in more than once, the ttyname argument may be used to indi- 
cate the appropriate terminal name. 
Permission to write may be denied or granted by use of the mesg command. At the outset writing is 
allowed. Certain commands, in particular nroff and pr(1) disallow messages in order to prevent messy out- 
put. 
If the character ‘!’ is found at the beginning of a line, write calls the shell to execute the rest of the line as a 
command. 
The following protocol is suggested for using write: when you first write to another user, wait for him to 
write back before starting to send. Each party should end each message with a distinctive signal—(o) for 
‘over’ is conventional—that the other may reply. (00) for ‘over and out’ is suggested when conversation is 
about to be terminated. 

FILES 
/etc/utmp to find user 
/bin/sh to execute ‘!’ 

SEE ALSO 


mesg(1), who(1), mail(1) 
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NAME 
xsend, xget, enroll — secret mail 


SYNOPSIS 
xsend person 
xget 
enroll 
DESCRIPTION 
These commands implement a secure communication channel; it is like mail(1), but no one can read the 
messages except the intended recipient. The method embodies a public-key cryptosystem using knapsacks. 


To receive messages, use enroll; it asks you for a password that you must subsequently quote in order to 
receive secret mail. 


To receive secret mail, use xget. It asks for your password, then gives you the messages. 


To send secret mail, use xsend in the same manner as the ordinary mail command. (However, it will accept 
only one target). A message announcing the receipt of secret mail is also sent by ordinary mail. 


FILES 
/ustr/spool/secretmail/*.key: keys 
/usr/spool/secretmail/*.[0-9]: messages 


SEE ALSO 
mail (1) 


BUGS 
It should be integrated with ordinary mail. The announcement of secret mail makes traffic analysis possi- 
ble. 
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NAME 
xstr — extract strings from C programs to implement shared strings 
SYNOPSIS 
xstr [-c ] [-] [ file ] 
DESCRIPTION 
Xstr maintains a file strings into which strings in component parts of a large program are hashed. These 
strings are replaced with references to this common area. This serves to implement shared constant strings, 
most useful if they are also read-only. 
The command 
xstr —c name 
will extract the strings from the C source in name, replacing string references by expressions of the form 
(&xstr[number]) for some number. An appropriate declaration of xstr is prepended to the file. The result- 
ing C text is placed in the file x.c, to then be compiled. The strings from this file are placed in the strings 
data base if they are not there already. Repeated strings and strings which are suffices of existing strings do 
not cause changes to the data base. 
After all components of a large program have been compiled a file xs.c declaring the common xstr space 
can be created by a command of the form 
xstr 
This xs.c file should then be compiled and loaded with the rest of the program. If possible, the array can be 
made read-only (shared) saving space and swap overhead. 
Xstr can also be used on a single file. A command 
xstr name 
creates files x.c and xs.c as before, without using or affecting any strings file in the same directory. 
It may be useful to run xstr after the C preprocessor if any macro definitions yield strings or if there is con- 
ditional code which contains strings which may not, in fact, be needed. Xstr reads from its standard input 
when the argument ‘—’ is given. An appropriate command sequence for running xstr after the C preproces- 
sor iS: 
ce -E name.c | xstr -c - 
cC -C X.C 
mv X.o name.o 
Xstr does not touch the file strings unless new items are added, thus make can avoid remaking xs.o unless 
truly necessary. 
FILES 
strings Data base of strings 
X.C Massaged C source 
XS.C C source for definition of array ‘xstr’ 
/tmp/xs* Temp file when “xstr name’ doesn’t touch strings 
SEE ALSO 
mkstr(1) 
BUGS 


If a string is a suffix of another string in the data base, but the shorter string is seen first by xstr both strings 
will be placed in the data base, when just placing the longer one there will do. 
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NAME 
yacc — yet another compiler-compiler 


SYNOPSIS 
yacc [ -vd ] grammar 


DESCRIPTION 
Yacc converts a context-free grammar into a set of tables for a simple automaton which executes an LR(1) 
parsing algorithm. The grammar may be ambiguous; specified precedence rules are used to break ambigui- 
ties. 


The output file, y.tab.c, must be compiled by the C compiler to produce a program yyparse. This program 
must be loaded with the lexical analyzer program, yylex, as well as main and yyerror, an error handling 
routine. These routines must be supplied by the user; Lex(1) is useful for creating lexical analyzers usable 
by yacc. 


If the -v flag is given, the file y.output is prepared, which contains a description of the parsing tables and a 
report on conflicts generated by ambiguities in the grammar. 


If the -d flag is used, the file y.tab.h is generated with the define statements that associate the yacc-assigned 
‘token codes’ with the user-declared ‘token names’. This allows source files other than y.tab.c to access the 
token codes. 


FILES 
y.output 
y.tab.c 
y.tab.h defines for token names 
yacc.tmp, yacc.acts temporary files 
/usr/lib/yaccpar _ parser prototype for C programs 
SEE ALSO 


lex(1) 
LR Parsing by A. V. Aho and S. C. Johnson, Computing Surveys, June, 1974. 
YACC — Yet Another Compiler Compiler by S. C. Johnson. 


DIAGNOSTICS 
The number of reduce-reduce and shift-reduce conflicts is reported on the standard output; a more detailed 
report is found in the y.output file. Similarly, if some rules are not reachable from the start symbol, this is 
also reported. 


BUGS 
Because file names are fixed, at most one yacc process can be active in a given directory at a time. 
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NAME 
yes — be repetitively affirmative 


SYNOPSIS 
yes [ expletive ] 


DESCRIPTION 
Yes repeatedly outputs “‘y’’, or if expletive is given, that is output repeatedly. Termination is by rubout. 
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NAME 

aardvark — yet another exploration game 
SYNOPSIS 

/usr/games/aardvark 
DESCRIPTION 


Aardvark is yet another computer fantasy simulation game of the adventure/zork genre. This one is written 
in DDL (Dungeon Definition Language) and is intended primarily as an example of how to write a dungeon 
in DDL. 


FILES 
/usr/games/lib/ddlrun ddI interpreter 
/usr/games/lib/aardvarkinternal form of aardvark dungeon 


AUTHOR 
Mike Urban, UCLA 
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NAME 

adventure — an exploration game 
SYNOPSIS 

/usr/games/adventure 
DESCRIPTION 


The object of the game is to locate and explore Colossal Cave, find the treasures hidden there, and bring 
them back to the building with you. The program is self-descriptive to a point, but part of the game is to 
discover its rules. 


To terminate a game, type ‘quit’; to save a game for later resumption, type ‘suspend’. 


BUGS 
Saving a game creates a large executable file instead of just the information needed to resume the game. 
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NAME 


arithmetic — provide drill in number facts 


SYNOPSIS 


/usr/games/arithmetic [ +—x/ ] [ range ] 


DESCRIPTION 


Arithmetic types out simple arithmetic problems, and waits for an answer to be typed in. If the answer is 
correct, it types back ‘‘Right!’’, and a new problem. If the answer is wrong, it replies ‘“What?’’, and waits 
for another answer. After every twenty problems, it publishes statistics on correctness and the time 
required to answer. 


To quit the program, type an interrupt (delete). 


The first optional argument determines the kind of problem to be generated; +—x/ respectively cause addi- 
tion, subtraction, multiplication, and division problems to be generated. One or more characters can be 
given; if more than one is given, the different types of problems will be mixed in random order; default is 
+-. 


Range is a decimal number; all addends, subtrahends, differences, multiplicands, divisors, and quotients 
will be less than or equal to the value of range. Default range is 10. 


At the start, all numbers less than or equal to range are equally likely to appear. If the respondent makes a 
mistake, the numbers in the problem which was missed become more likely to reappear. 


As a matter of educational philosophy, the program will not give correct answers, since the learner should, 
in principle, be able to calculate them. Thus the program is intended to provide drill for someone just past 
the first learning stage, not to teach number facts de novo. For almost all users, the relevant statistic should 
be time per problem, not percent correct. 
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NAME 
backgammon — the game 


SYNOPSIS 
/usr/games/backgammon 


DESCRIPTION 
This program does what you expect. It will ask whether you need instructions. 
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NAME 
banner — print large banner on printer 


SYNOPSIS 
/usr/games/banner [ —wn ] message ... 


DESCRIPTION 
Banner prints a large, high quality banner on the standard output. If the message is omitted, it prompts for 
and reads one line of its standard input. If —w is given, the output is scrunched down from a width of 132 to 
n, suitable for a narrow terminal. If nm is omitted, it defaults to 80. 


The output should be printed on a hard-copy device, up to 132 columns wide, with no breaks between the 
pages. The volume is great enough that you may want a printer or a fast hardcopy terminal, but if you are 
patient, a decwriter or other 300 baud terminal will do. 


BUGS 
Several ASCII characters are not defined, notably <, >, [, ],\,*,_, {. }. |, and ~. Also, the characters ", ’, 
and & are funny looking (but in a useful way.) 
The —w option is implemented by skipping some rows and columns. The smaller it gets, the grainier the 
output. Sometimes it runs letters together. 

AUTHOR 


Mark Horton 
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NAME 

battlestar — a tropical adventure game 
SYNOPSIS 

battlestar [ -r (recover a saved game) | 
DESCRIPTION 


Battlestar is an adventure game in the classic style. However, It’s slightly less of a puzzle and more a game 
of exploration. There are a few magical words in the game, but on the whole, simple English should suffice 
to make one’s desires understandable to the parser. 


THE SETTING 
In the days before the darkness came, when battlestars ruled the heavens... 


Three He made and gave them to His daughters, 
Beautiful nymphs, the goddesses of the waters. 

One to bring good luck and simple feats of wonder, 
Two to wash the lands and churn the waves asunder, 
Three to rule the world and purge the skies with thunder. 


In those times great wizards were known and their powers were beyond belief. They could take any object 
from thin air, and, uttering the word ‘su’ could disappear. 


In those times men were known for their lust of gold and desire to wear fine weapons. Swords and coats of 
mail were fashioned that could withstand a laser blast. 


But when the darkness fell, the rightful reigns were toppled. Swords and helms and heads of state went rol- 
ling across the grass. The entire fleet of battlestars was reduced to a single ship. 


SAMPLE COMMANDS 
take --- take an object 
drop --- drop an object 
wear --- wear an object you are holding 
draw--- carry an object you are wearing 
puton” --- take an object and wear it 
take off -- draw an object and drop it 


throw <object> <direction> 


! <shell esc> 


IMPLIED OBJECTS 
>-: take watermelon 
watermelon: 
Taken. 
>-: eat 
watermelon: 
Eaten. 
>-: take knife and sword and apple, drop all 
knife: 
Taken. 
broadsword: 
Taken. 
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apple: 
Taken. 
knife: 
Dropped. 
broadsword: 
Dropped. 
apple: 
Dropped. 
>-: get 
knife: 
Taken. 


Notice that the "shadow" of the next word stays around if you want to take advantage of it. That is, saying 
"take knife" and then "drop" will drop the knife you just took. 


SCORE & INVEN 
The two commands "score" and "inven" will print out your current status in the game. 


SAVING A GAME 
The command "save" will save your game in a file called "Bstar.". You can recover a saved game by using 
the "-r" option when you start up the game. 


DIRECTIONS 
The compass directions N, S, E, and W can be used if you have a compass. If you don’t have a compass, 
you'll have to say R, L, A, or B, which stand for Right, Left, Ahead, and Back. Directions printed in room 
descriptions are always printed in R, L, A, & B relative directions. 


HISTORY 
I wrote Battlestar in 1979 in order to experiment with the niceties of the C Language. Most interesting 
things that happen in the game are hardwired into the code, so don’t send me any hate mail about it! 
Instead, enjoy art for art’s sake! 


AUTHOR 
David Riggle 


INSPIRATION & ASSISTANCE 
Chris Guthrie 
Peter Da Silva 
Kevin Brown 
Edward Wang 
Ken Arnold & Company 


BUGS 
Countless. 


FAN MAIL 
Send to edward%ucbarpa @ Berkeley.arpa, chris%ucbcory @berkeley.arpa, riggle.pa@ xerox.arpa. 
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NAME 
bed — convert to antique media 


SYNOPSIS 
/usr/games/bcd text 


DESCRIPTION 
Bcd converts the literal text into a form familiar to old-timers. 


SEE ALSO 
dd(1) 
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NAME 


boggle — play the game of boggle 


SYNOPSIS 


/usr/games/boggle [ + ] [ ++ ] 


DESCRIPTION 


This program is intended for people wishing to sharpen their skills at Boggle (TM Parker Bros.). If you 
invoke the program with 4 arguments of 4 letters each, (e.g. ‘‘boggle appl epie moth erhd’’) the program 
forms the obvious Boggle grid and lists all the words from /usr/dict/words found therein. If you invoke the 
program without arguments, it will generate a board for you, let you enter words for 3 minutes, and then tell 
you how well you did relative to /usr/dict/words. 


The object of Boggle is to find, within 3 minutes, as many words as possible in a 4 by 4 grid of letters. 
Words may be formed from any sequence of 3 or more adjacent letters in the grid. The letters may join hor- 
izontally, vertically, or diagonally. However, no position in the grid may be used more than once within 
any one word. In competitive play amongst humans, each player is given credit for those of his words 
which no other player has found. 


In interactive play, enter your words separated by spaces, tabs, or newlines. A bell will ring when there is 
2:00, 1:00, 0:10, 0:02, 0:01, and 0:00 time left. You may complete any word started before the expiration of 
time. You can surrender before time is up by hitting *break’. While entering words, your erase character is 
only effective within the current word and your line kill character is ignored. 


Advanced players may wish to invoke the program with | or 2 +’s as the first argument. The first + removes 
the restriction that positions can only be used once in each word. The second + causes a position to be con- 
sidered adjacent to itself as well as its (up to) 8 neighbors. 
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NAME 


canfield, cfscores — the solitaire card game canfield 


SYNOPSIS 


/usr/games/canfield 
/usr/games/cfscores 


DESCRIPTION 


FILES 


BUGS 


If you have never played solitaire before, it is recommended that you consult a solitaire instruction book. In 
Canfield, tableau cards may be built on each other downward in alternate colors. An entire pile must be 
moved as a unit in building. Top cards of the piles are available to be played on foundations, but never into 
empty spaces. 


Spaces must be filled from the stock. The top card of the stock also is available to be played on foundations 
or built on tableau piles. After the stock is exhausted, tableau spaces may be filled from the talon and the 
player may keep them open until he wishes to use them. 


Cards are dealt from the hand to the talon by threes and this repeats until there are no more cards in the 
hand or the player quits. To have cards dealt onto the talon the player types ’ht’ for his move. Foundation 
base cards are also automatically moved to the foundation when they become available. 


The command ’c’ causes canfield to maintain card counting statistics on the bottom of the screen. When 
properly used this can greatly increase one’s chances of winning. 


The rules for betting are somewhat less strict than those used in the official version of the game. The initial 
deal costs $13. You may quit at this point or inspect the game. Inspection costs $13 and allows you to 
make as many moves as possible without moving any cards from your hand to the talon. (The initial deal 
places three cards on the talon; if all these cards are used, three more are made available.) Finally, if the 
game seems interesting, you must pay the final installment of $26. At this point you are credited at the rate 
of $5 for each card on the foundation; as the game progresses you are credited with $5 for each card that is 
moved to the foundation. Each run through the hand after the first costs $5. The card counting feature 
costs $1 for each unknown card that is identified. If the information is toggled on, you are only charged for 
cards that became visible since it was last turned on. Thus the maximum cost of information is $34. Play- 
ing time is charged at a rate of $1 per minute. 


With no arguments, the program cfscores prints out the current status of your canfield account. If a user 
name is specified, it prints out the status of their canfield account. If the —a flag is specified, it prints out the 
canfield accounts for all users that have played the game since the database was set up. 


/usr/games/canfield the game itself 
/usr/games/cfscores the database printer 
/ust/games/lib/cfscores __ the database of scores 


It is impossible to cheat. 


AUTHORS 


Originally written: Steve Levine 
Further random hacking by: Steve Feldman, Kirk McKusick, Mikey Olson, and Eric Allman. 
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NAME 
chess — the game of chess 


SYNOPSIS 
/usr/games/chess 


DESCRIPTION 
Chess is a computer program that plays class D chess. Moves may be given either in standard (descriptive) 
notation or in algebraic notation. The symbol ‘+’ is used to specify check; ‘o-o’ and ‘o-0-o’ specify cas- 
tling. To play black, type ‘first’; to print the board, type an empty line. 


Each move is echoed in the appropriate notation followed by the program’s reply. 


FILES 

/usr/lib/chess binary image to run in compatibility mode 
DIAGNOSTICS 

The most cryptic diagnostic is ‘eh?’ which means that the input was syntactically incorrect. 
BUGS 


Pawns may be promoted only to queens. The book of opening moves has disappeared. 
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NAME 


ching — the book of changes and other cookies 


SYNOPSIS 


/usr/games/ching [ hexagram ] 


DESCRIPTION 


The J Ching or Book of Changes is an ancient Chinese oracle that has been in use for centuries as a source 
of wisdom and advice. 


The text of the oracle (as it is sometimes known) consists of sixty-four hexagrams, each symbolized by a 
particular arrangement of six straight (——) and broken (—-—) lines. These lines have values ranging from 
six through nine, with the even values indicating the broken lines. 


Each hexagram consists of two major sections. The Judgement relates specifically to the matter at hand 
(E.g., “‘It furthers one to have somewhere to go.’’) while the Image describes the general attributes of the 
hexagram and how they apply to one’s own life (‘“Thus the superior man makes himself strong and untir- 
ing.’’). 

When any of the lines have the values six or nine, they are moving lines; for each there is an appended 
judgement which becomes significant. Furthermore, the moving lines are inherently unstable and change 
into their opposites; a second hexagram (and thus an additional judgement) is formed. 


Normally, one consults the oracle by fixing the desired question firmly in mind and then casting a set of 
changes (lines) using yarrow-stalks or tossed coins. The resulting hexagram will be the answer to the ques- 
tion. 


Using an algorithm suggested by S. C. Johnson, the UNIX oracle simply reads a question from the stan- 
dard input (up to an EOF) and hashes the individual characters in combination with the time of day, process 
id and any other magic numbers which happen to be lying around the system. The resulting value is used 
as the seed of a random number generator which drives a simulated coin-toss divination. The answer is 
then piped through nroff for formatting and will appear on the standard output. 


For those who wish to remain steadfast in the old traditions, the oracle will also accept the results of a per- 
sonal divination using, for example, coins. To do this, cast the change and then type the resulting line val- 
ues as an argument. 


The impatient modern may prefer to settle for Chinese cookies; try fortune (6). 


SEE ALSO 


It furthers one to see the great man. 


DIAGNOSTICS 


BUGS 


The great prince issues commands, 
Founds states, vests families with fiefs. 
Inferior people should not be employed. 


Waiting in the mud 
Brings about the arrival of the enemy. 


If one is not extremely careful, 
Somebody may come up from behind and strike him. 
Misfortune. 
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NAME 


cribbage — the card game cribbage 


SYNOPSIS 


/usr/games/cribbage [ -req | name ... 


DESCRIPTION 


FILES 


Cribbage plays the card game cribbage, with the program playing one hand and the user the other. The 
program will initially ask the user if the rules of the game are needed — if so, it will print out the appropriate 
section from According to Hoyle with more (I). 


Cribbage options include: 


-e When the player makes a mistake scoring his hand or crib, provide an explanation of the correct 
score. (This is especially useful for beginning players.) 


-q Print a shorter form of all messages — this is only recommended for users who have played the 
game without specifying this option. 


-r Instead of asking the player to cut the deck, the program will randomly cut the deck. 


Cribbage first asks the player whether he wishes to play a short game (“‘once around’’, to 61) or a long 
game (“‘twice around’’, to 121). A response of ‘s’ will result in a short game, any other response will play 
along game. 


At the start of the first game, the program asks the player to cut the deck to determine who gets the first 
crib. The user should respond with a number between 0 and 51, indicating how many cards down the deck 
is to be cut. The player who cuts the lower ranked card gets the first crib. If more than one game is played, 
the loser of the previous game gets the first crib in the current game. 


For each hand, the program first prints the player’s hand, whose crib it is, and then asks the player to dis- 
card two cards into the crib. The cards are prompted for one per line, and are typed as explained below. 


After discarding, the program cuts the deck (if it is the player’s crib) or asks the player to cut the deck (if 
it’s its crib); in the latter case, the appropriate response is a number from 0 to 39 indicating how far down 
the remaining 40 cards are to be cut. 


After cutting the deck, play starts with the non-dealer (the person who doesn’t have the crib) leading the 
first card. Play continues, as per cribbage, until all cards are exhausted. The program keeps track of the 
scoring of all points and the total of the cards on the table. 


After play, the hands are scored. The program requests the player to score his hand (and the crib, if it is 
his) by printing out the appropriate cards (and the cut card enclosed in brackets). Play continues until one 
player reaches the game limit (61 or 121). 


A carriage return when a numeric input is expected is equivalent to typing the lowest legal value; when cut- 
ting the deck this is equivalent to choosing the top card. 


Cards are specified as rank followed by suit. The ranks may be specified as one of: ‘a’, ‘2’, ‘3’, ‘4’, ‘5’, ‘6’, 
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‘T’, 8°, 9, “tv, Z, ‘q’, and ‘k’, or alternatively, one of: ‘‘ace’’, “‘two’’, ‘‘three’’, ‘‘four’’, “‘five’’, ‘‘six’’, 
““seven’’, ‘‘eight’’, “‘nine’’, ‘‘ten’’, ‘‘jack’’, ‘‘queen’’, and ‘‘king’’. Suits may be specified as: ‘s’, ‘h’, ‘d’, 
and ‘c’, or alternatively as: ‘‘spades’’, “‘hearts’’, ‘“diamonds’’, and “‘clubs’’. A card may be specified as: 
<rank> ‘‘ ’’ <suit>, or: <rank> “‘ of ’’ <suit>. If the single letter rank and suit designations are used, the 
space separating the suit and rank may be left out. Also, if only one card of the desired rank is playable, 
typing the rank is sufficient. For example, if your hand was ‘‘2H, 4D, 5C, 6H, JC, KD’’ and it was desired 
to discard the king of diamonds, any of the following could be typed: ‘‘k’’, ‘‘king’’, ‘‘kd’’, ‘‘k d’’, ‘‘k of 


d’’, “‘king d’’, ‘‘king of d’’, ‘‘k diamonds’’, ‘‘k of diamonds’’, ‘‘king diamonds’’, or ‘‘king of diamonds’’. 


/usr/games/cribbage 
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AUTHORS 
Earl T. Cohen wrote the logic. Ken Arnold added the screen oriented interface. 
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NAME 
doctor — interact with a psychoanalyst 

SYNOPSIS 
/usr/games/doctor 

DESCRIPTION 
Doctor is a lisp-language version of the legendary ELIZA program of Joseph Weizenbaum. This script 
"simulates" a Rogerian psychoanalyst. Type in lower case, and when you get tired or bored, type your 
interrupt character (either control-C or Rubout). Remember to type two carriage returns when you want it to 
answer. 
In order to run this you must have a Franz Lisp system in /usr/ucb/lisp. 

AUTHORS 
Adapted for Lisp by Jon L White, moved to Franz by John Foderaro, from an original script by Joseph 
Weizenbaum. 
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NAME 
fish — play “‘Go Fish’’ 


SYNOPSIS 
/usr/games/fish 


DESCRIPTION 

Fish plays the game of ‘‘Go Fish’’, a childrens’ card game. The Object is to accumulate ‘books’ of 4 cards 
with the same face value. The players alternate turns; each turn begins with one player selecting a card 
from his hand, and asking the other player for all cards of that face value. If the other player has one or 
more cards of that face value in his hand, he gives them to the first player, and the first player makes 
another request. Eventually, the first player asks for a card which is not in the second player’s hand: he 
replies “GO FISH!’ The first player then draws a card from the ‘pool’ of undealt cards. If this is the card he 
had last requested, he draws again. When a book is made, either through drawing or requesting, the cards 
are laid down and no further action takes place with that face value. 


To play the computer, simply make guesses by typing a, 2, 3, 4, 5, 6, 7, 8, 9, 10, j, q, or k when asked. Hit- 
ting return gives you information about the size of my hand and the pool, and tells you about my books. 
Saying ‘p’ as a first guess puts you into ‘pro’ level; The default is pretty dumb. 
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NAME 


fortune — print a random, hopefully interesting, adage 


SYNOPSIS 


/usr/games/fortune [ — ] [ —wslao ] 


DESCRIPTION 
Fortune with no arguments prints out a random adage. The flags mean: 


—-W 


-s 
-l 
—0 


—a 


Waits before termination for an amount of time calculated from the number of characters in the mes- 
sage. This is useful if it is executed as part of the logout procedure to guarantee that the message can 
be read before the screen is cleared. 


Short messages only. 
Long messages only. 
Choose from an alternate list of adages, often used for potentially offensive ones. 


Choose from either list of adages. 


post..This file must be created by strfile(6), 


FILES 

/usr/games/lib/fortunes.dat 
AUTHOR 

Ken Arnold 
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NAME 

hangman — Computer version of the game hangman 
SYNOPSIS 

/usr/games/hangman 
DESCRIPTION 


In hangman, the computer picks a word from the on-line word list and you must try to guess it. The com- 
puter keeps track of which letters have been guessed and how many wrong guesses you have made on the 
screen in a graphic fashion. 


FILES 
/usr/dict/words On-line word list 


AUTHOR 
Ken Arnold 
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NAME 
hunt — a multi-player multi-terminal game 


SYNOPSIS 
/usr/games/hunt [-q] [-m] [hostname] [-] name] 


DESCRIPTION 
The object of the game hunt is to kill off the other players. There are no rooms, no treasures, and no mon- 
sters. Instead, you wander around a maze, find grenades, trip mines, and shoot down walls and players. 
The more players you kill before you die, the better your score is. If the -m flag is given, you enter the 
game as a monitor (you can see the action but you cannot play). 


Hunt normally looks for an active game on the local network; if none is found, it starts one up on the local 
host. One may specify the location of the game by giving the hostname argument. The player name may 
be specified on the command line by using the -1 option. This command syntax was chosen for rlogin/rsh 
compatibility. If the -q flag is given, hunt queries the network and reports if an active game were found. 
This is useful for .login scripts. 


Hunt only works on crt (vdt) terminals with at least 24 lines, 80 columns, and cursor addressing. The 
screen is divided in to 3 areas. On the right hand side is the status area. It shows you how much damage 
you’ ve sustained, how many charges you have left, who’s in the game, who’s scanning (the asterisk in front 
of the name), who’s cloaked (the plus sign in front of the name), and other players’ scores. Most of the rest 
of the screen is taken up by your map of the maze, except for the 24th line, which is used for longer mes- 
sages that don’t fit in the status area. 


Hunt uses the same keys to move as vi does, i.e., h,j,k, and 1 for left, down, up, right respectively. To 
change which direction you’re facing in the maze, use the upper case version of the movement key (i.e., 
HJKL). 


Other commands are: 


f — Fire (in the direction you’re facing) (Takes | charge) 

g — Throw grenade (in the direction you’re facing) (Takes 9 charges) 
F — Throw satchel charge (Takes 25 charges) 

G — Throw bomb (Takes 49 charges) 

fo) — Throw small slime bomb (Takes 15 charges) 

O — Throw big slime bomb (Takes 30 charges) 

S — Scan (show where other players are) (Takes 1 charge) 

c — Cloak (hide from scanners) (Takes 1 charge) 


“L — Redraw screen 
q — Quit 


Knowing what the symbols on the screen often helps: 


—~|+ —walls 

/\ — diagonal (deflecting) walls 
# — doors (dispersion walls) 

: — small mine 

g — large mine 

— shot 

— grenade 

— satchel charge 

— bomb 

S — small slime bomb 

$ — big slime bomb 

><*v — you facing right, left, up, or down 


@oer- 
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}{i! -other players facing right, left, up, or down 


* — explosion 

\I/ 

—*— — grenade and large mine explosion 
/\\ 


Satchel and bomb explosions are larger than grenades (5x5, 7x7, 
and 3x3 respectively). 


Other helpful hints: 


e You can only fire in the direction you are facing. 

¢ You can only fire three shots in a row, then the gun must cool. 

e A shot only affects the square it hits. 

e Shots and grenades move 5 times faster than you do. 

¢ To stab someone, you must face that player and move at them. 

e Stabbing does 2 points worth of damage and shooting does 5 points. 

e Slime does 5 points of damage each time it hits. 

e You start with 15 charges and get 5 more for every new player. 

e A grenade affects the nine squares centered about the square it hits. 

e A satchel affects the twenty-five squares centered about the square it hits. 

e¢ A bomb affects the forty-nine squares centered about the square it hits. 

e Slime affects all squares it oozes over (15 or 30 respectively). 

¢ One small mine and one large mine is placed in the maze for every new player. A mine has a 5% proba- 
bility of tripping when you walk directly at it; 50% when going sideways on to it; 95% when backing up 
on to it. Tripping a mine costs you 5 points or 10 points respectively. Defusing a mine is worth | charge 
or 9 charges respectively. 

You cannot see behind you. 

Scanning lasts for (20 times the number of players) turns. Scanning takes | ammo charge, so don’t waste 
all your charges scanning. 

Cloaking lasts for 20 turns. 

Whenever you kill someone, you get 2 more damage capacity points and 2 damage points taken away. 
Maximum typeahead is 5 characters. 

A shot destroys normal (i.e., non-diagonal, non-door) walls. 

Diagonal walls deflect shots and change orientation. 

Doors disperse shots in random directions (up, down, left, right). 

Diagonal walls and doors cannot be destroyed by direct shots but may be destroyed by an adjacent 
grenade explosion. 

Slime goes around walls, not through them. 

Walls regenerate, reappearing in the order they were destroyed. One percent of the regenerated walls will 
be diagonal walls or doors. When a wall is generated directly beneath a player, he is thrown in a random 
direction for a random period of time. When he lands, he sustains damage (up to 20 percent of the 
amount of damage he had before impact); that is, the less damage he had, the more nimble he is and 
therefore less likely to hurt himself on landing. 


The environment variable HUNT is checked to get the player name. If you don’t have this variable set, 
hunt will ask you what name you want to play under. If it is set, you may also set up a single character 
keyboard map, but then you have to enumerate the options: 

e.g. setenv HUNT ‘‘name=Sneaky,mapkey=zoFfGg1f2g3F4G”’ 
sets the player name to Sneaky, and the maps z to o, F to f, G to g, 1 to f, 2 to g, 3 to F, and 4 to G. The 
mapkey option must be last. 
e It’s a boring game if you’re the only one playing. 
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Your score is the ratio of number of kills to number of times you entered the game and is only kept for the 
duration of a single session of hunt. 


Hunt normally drives up the load average to be about (number_of_players + 0.5) greater than it would be 
without a hunt game executing. A limit of three players per host and nine players total is enforced by hunt. 


FILES 
/usr/games/lib/hunt.driver game coordinator 


AUTHORS 
Conrad Huang, Ken Arnold, and Greg Couch; University of California, San Francisco, Computer Graphics 
Lab 


ACKNOWLEDGEMENTS 
We thank Don Kneller, John Thomason, Eric Pettersen, and Scott Weiner for providing endless hours of 
play-testing to improve the character of the game. We hope their significant others will forgive them; we 
certainly don’t. 


BUGS 
To keep up the pace, not everything is as realistic as possible. 


There were some bugs in early releases of 4.2 BSD that hunt helped discover; hunt will crash your system 
if those bugs haven’t been fixed. 
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mille — play Mille Bournes 


SYNOPSIS 


/usr/games/mille [ file ] 


DESCRIPTION 


Mille plays a two-handed game reminiscent of the Parker Brother’s game of Mille Bournes with you. The 
rules are described below. If a file name is given on the command line, the game saved in that file is 


started. 


When a game is started up, the bottom of the score window will contain a list of commands. They are: 


P 
D 


Pick a card from the deck. This card is placed in the ‘P’ slot in your hand. 


Discard a card from your hand. To indicate which card, type the number of the card in the hand 
(or ‘*P’’ for the just-picked card) followed by a <RETURN> or <SPACE>. The <RETURN or 
<SPACE> is required to allow recovery from typos which can be very expensive, like discarding 
safeties. 


Use a card. The card is again indicated by its number, followed by a<RETURN> or <SPACE>. 


Toggle ordering the hand. By default off, if turned on it will sort the cards in your hand appropri- 
ately. This is not recommended for the impatient on slow terminals. 


Quit the game. This will ask for confirmation, just to be sure. Hitting <DELETE> (or 
<RUBOUTS>) is equivalent. 


Save the game in a file. If the game was started from a file, you will be given an opportunity to 
save it on the same file. If you don’t wish to, or you did not start from a file, you will be asked for 
the file name. If you type a<RETURN> without a name, the save will be terminated and the game 
resumed. 


Redraw the screen from scratch. The command “L (control ‘L’) will also work. 


Toggle window type. This switches the score window between the startup window (with all the 
command names) and the end-of-game window. Using the end-of-game window saves time by 
eliminating the switch at the end of the game to show the final score. Recommended for hackers 
and other miscreants. 


If you make a mistake, an error message will be printed on the last line of the score window, and a bell will 


beep. 


At the end of each hand or game, you will be asked if you wish to play another. If not, it will ask you if 
you want to save the game. If you do, and the save is unsuccessful, play will be resumed as if you had said 
you wanted to play another hand/game. This allows you to use the ‘‘S’’ command to reattempt the save. 


AUTHOR 


Ken Arnold 
(The game itself is a product of Parker Brothers, Inc.) 


SEE ALSO 


curses(3X), Screen Updating and Cursor Movement Optimization: A Library Package, Ken Arnold 


CARDS 


Here is some useful information. The number in parentheses after the card name is the number of that card 
in the deck: 
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RULES 


Hazard Repair Safety 

Out of Gas (2) Gasoline (6) Extra Tank (1) 
Flat Tire (2) Spare Tire (6) Puncture Proof (1) 
Accident (2) Repairs (6) Driving Ace (1) 
Stop (4) Go (14) Right of Way (1) 


Speed Limit (3) — End of Limit (6) 


25 — (10), 50 — (10), 75 — (10), 100 — (12), 200 — (4) 


Object: The point of this game is to get a total of 5000 points in several hands. Each hand is a race to put 
down exactly 700 miles before your opponent does. Beyond the points gained by putting down milestones, 
there are several other ways of making points. 


Overview: The game is played with a deck of 101 cards. Distance cards represent a number of miles trav- 
eled. They come in denominations of 25, 50, 75, 100, and 200. When one is played, it adds that many 
miles to the player’s trip so far this hand. Hazard cards are used to prevent your opponent from putting 
down Distance cards. They can only be played if your opponent has a Go card on top of the Battle pile. 
The cards are Out of Gas, Accident, Flat Tire, Speed Limit, and Stop. Remedy cards fix problems caused 
by Hazard cards played on you by your opponent. The cards are Gasoline, Repairs, Spare Tire, End of 
Limit, and Go. Safety cards prevent your opponent from putting specific Hazard cards on you in the first 
place. They are Extra Tank, Driving Ace, Puncture Proof, and Right of Way, and there are only one of 
each in the deck. 


Board Layout: The board is split into several areas. From top to bottom, they are: SAFETY AREA (unla- 
beled): This is where the safeties will be placed as they are played. HAND: These are the cards in your 
hand. BATTLE: This is the Battle pile. All the Hazard and Remedy Cards are played here, except the 
Speed Limit and End of Limit cards. Only the top card is displayed, as it is the only effective one. SPEED: 
The Speed pile. The Speed Limit and End of Limit cards are played here to control the speed at which the 
player is allowed to put down miles. MILEAGE: Miles are placed here. The total of the numbers shown 
here is the distance traveled so far. 


Play: The first pick alternates between the two players. Each turn usually starts with a pick from the deck. 
The player then plays a card, or if this is not possible or desirable, discards one. Normally, a play or dis- 
card of a single card constitutes a turn. If the card played is a safety, however, the same player takes 
another turn immediately. 


This repeats until one of the players reaches 700 points or the deck runs out. If someone reaches 700, they 
have the option of going for an Extension, which means that the play continues until someone reaches 1000 
miles. 


Hazard and Remedy Cards: Hazard Cards are played on your opponent’s Battle and Speed piles. Rem- 
edy Cards are used for undoing the effects of your opponent’s nastiness. 


Go (Green Light) must be the top card on your Battle pile for you to play any mileage, unless you have 
played the Right of Way card (see below). 

Stop is played on your opponent’s Go card to prevent them from playing mileage until they play a Go 
card. 

Speed Limit is played on your opponent’s Speed pile. Until they play an End of Limit they can only 
play 25 or 50 mile cards, presuming their Go card allows them to do even that. 

End of Limit is played on your Speed pile to nullify a Speed Limit played by your opponent. 

Out of Gas is played on your opponent’s Go card. They must then play a Gasoline card, and then a Go 
card before they can play any more mileage. 

Flat Tire is played on your opponent’s Go card. They must then play a Spare Tire card, and then a Go 
card before they can play any more mileage. 
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Accident is played on your opponent’s Go card. They must then play a Repairs card, and then a Go card 
before they can play any more mileage. 


Safety Cards: Safety cards prevent your opponent from playing the corresponding Hazard cards on you for 
the rest of the hand. It cancels an attack in progress, and always entitles the player to an extra turn. 

Right of Way prevents your opponent from playing both Stop and Speed Limit cards on you. It also acts 
as a permanent Go card for the rest of the hand, so you can play mileage as long as there is not a Hazard 
card on top of your Battle pile. In this case only, your opponent can play Hazard cards directly on a Rem- 
edy card other than a Go card. 

Extra Tank When played, your opponent cannot play an Out of Gas on your Battle Pile. 

Puncture Proof When played, your opponent cannot play a Flat Tire on your Battle Pile. 

Driving Ace When played, your opponent cannot play an Accident on your Battle Pile. 


Distance Cards: Distance cards are played when you have a Go card on your Battle pile, or a Right of Way 
in your Safety area and are not stopped by a Hazard Card. They can be played in any combination that 
totals exactly 700 miles, except that you cannot play more than two 200 mile cards in one hand. A hand 
ends whenever one player gets exactly 700 miles or the deck runs out. In that case, play continues until nei- 
ther someone reaches 700, or neither player can use any cards in their hand. If the trip is completed after 
the deck runs out, this is called Delayed Action. 


Coup Fourré: This is a French fencing term for a counter-thrust move as part of a parry to an opponents 
attack. In Mille Bournes, it is used as follows: If an opponent plays a Hazard card, and you have the corre- 
sponding Safety in your hand, you play it immediately, even before you draw. This immediately removes 
the Hazard card from your Battle pile, and protects you from that card for the rest of the game. This gives 
you more points (see ‘“Scoring’’ below). 


Scoring: Scores are totaled at the end of each hand, whether or not anyone completed the trip. The terms 
used in the Score window have the following meanings: 

Milestones Played: Each player scores as many miles as they played before the trip ended. 

Each Safety: 100 points for each safety in the Safety area. 

All 4 Safeties: 300 points if all four safeties are played. 

Each Coup Fouré: 300 points for each Coup Fouré accomplished. 


The following bonus scores can apply only to the winning player. 
Trip Completed: 400 points bonus for completing the trip to 700 or 1000. 
Safe Trip: 300 points bonus for completing the trip without using any 200 mile cards. 
Delayed Action: 300 points bonus for finishing after the deck was exhausted. 
Extension: 200 points bonus for completing a 1000 mile trip. 
Shut-Out: 500 points bonus for completing the trip before your opponent played any mileage cards. 


Running totals are also kept for the current score for each player for the hand (Hand Total), the game 
(Overall Total), and number of games won (Games). 


4th Berkeley Distribution May 6, 1986 3 


MONOP (6) UNIX Programmer’s Manual MONOP (6 ) 


NAME 

monop — Monopoly game 
SYNOPSIS 

/usr/games/monop [ file ] 
DESCRIPTION 


Monop is reminiscent of the Parker Brother’s game Monopoly, and monitors a game between | to 9 users. 
It is assumed that the rules of Monopoly are known. The game follows the standard rules, with the excep- 
tion that, if a property goes up for auction and there are only two solvent players, no auction is held and the 
property remains unowned. 


The game, in effect, lends the player money, so it is possible to buy something which you cannot afford. 
However, as soon as a person goes into debt, he must ‘‘fix the problem’’, i.e., make himself solvent, before 
play can continue. If this is not possible, the player’s property reverts to his debtee, either a player or the 
bank. A player can resign at any time to any person or the bank, which puts the property back on the board, 
unowned. 


Any time that the response to a question is a string, e.g., a name, place or person, you can type *?’ to geta 
list of valid answers. It is not possible to input a negative number, nor is it ever necessary. 

A Summary of Commands: 

quit: quit game: This allows you to quit the game. It asks you if you’re sure. 


print: print board: This prints out the current board. The columns have the following meanings (col- 
umn headings are the same for the where, own holdings, and holdings commands): 


Name The first ten characters of the name of the square 

Own The number of the owner of the property. 

Price The cost of the property (if any) 

Mg _ This field has a ‘*’ in it if the property is mortgaged 

# If the property is a Utility or Railroad, this is the number of such owned by the owner. 
If the property is land, this is the number of houses on it. 

Rent Current rent on the property. If it is not owned, there is no rent. 


where: where players are: Tells you where all the players are. A ‘*’ indicates the current player. 


own holdings: 
List your own holdings, i.e., money, get-out-of-jail-free cards, and property. 


holdings: holdings list: Look at anyone’s holdings. It will ask you whose holdings you wish to look at. 
When you are finished, type ‘‘done’’. 


shell: shell escape: Escape to a shell. When the shell dies, the program continues where you left off. 


mortgage: mortgage property: Sets up a list of mortgageable property, and asks which you wish to mort- 
gage. 

unmortgage: 
unmortgage property: Unmortgage mortgaged property. 


buy: buy houses: Sets up a list of monopolies on which you can buy houses. If there is more than 
one, it asks you which you want to buy for. It then asks you how many for each piece of prop- 
erty, giving the current amount in parentheses after the property name. If you build in an 
unbalanced manner (a disparity of more than one house within the same monopoly), it asks you 
to re-input things. 
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sell: 


card: 


pay: 


trade: 


resign: 


Save: 


restore: 


roll: 


AUTHOR 


FILES 


BUGS 


Ken Arnold 
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sell houses: Sets up a list of monopolies from which you can sell houses. It operates in an 
analogous manner to buy. 


card for jail: Use a get-out-of-jail-free card to get out of jail. If you’re not in jail, or you don’t 
have one, it tells you so. 


pay for jail: Pay $50 to get out of jail, from whence you are put on Just Visiting. Difficult to 
do if you’re not there. 


This allows you to trade with another player. It asks you whom you wish to trade with, and 
then asks you what each wishes to give up. You can get a summary at the end, and, in all 
cases, it asks for confirmation of the trade before doing it. 


Resign to another player or the bank. If you resign to the bank, all property reverts to its virgin 
state, and get-out-of-jail free cards revert to the deck. 


save game: Save the current game in a file for later play. You can continue play after saving, 
either by adding the file in which you saved the game after the monop command, or by using 
the restore command (see below). It will ask you which file you wish to save it in, and, if the 
file exists, confirm that you wish to overwrite it. 


restore game: Read in a previously saved game from a file. It leaves the file intact. 


Roll the dice and move forward to your new location. If you simply hit the <RETURN> key 
instead of a command, it is the same as typing roll. 


/usr/games/lib/cards.pck Chance and Community Chest cards 


No command can be given an argument instead of a response to a query. 
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NAME 
number — convert Arabic numerals to English 


SYNOPSIS 
/usr/games/number 


DESCRIPTION 
Number copies the standard input to the standard output, changing each decimal number to a fully spelled 


out version. 
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NAME 


quiz — test your knowledge 


SYNOPSIS 


/usr/games/quiz [ -i file ] [ -t ] | category1 category? ] 


DESCRIPTION 


FILES 


BUGS 


Quiz gives associative knowledge tests on various subjects. It asks items chosen from category] and 
expects answers from category2. If no categories are specified, quiz gives instructions and lists the avail- 
able categories. 


Quiz tells a correct answer whenever you type a bare newline. At the end of input, upon interrupt, or when 
questions run out, quiz reports a score and terminates. 


The -t flag specifies ‘tutorial’ mode, where missed questions are repeated later, and material is gradually 
introduced as you learn. 


The -i flag causes the named file to be substituted for the default index file. The lines of these files have the 
syntax: 

line = category newline | category ‘:’ line 

category = alternate | category * |’ alternate 

alternate = empty | alternate primary 

primary = character Rig category ‘]’ | option 

option =‘{’ category ‘}’ 


The first category on each line of an index file names an information file. The remaining categories specify 
the order and contents of the data in each line of the information file. Information files have the same syn- 
tax. Backslash ‘\ is used as with sh(1) to quote syntactically significant characters or to insert transparent 
newlines into a line. When either a question or its answer is empty, quiz will refrain from asking it. 


/usr/games/quiz.k/* 


The construct ‘a | ab’ doesn’t work in an information file. Use ‘a{b}’. 
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NAME 
rain — animated raindrops display 


SYNOPSIS 
/usr/games/rain 


DESCRIPTION 
Rain’s display is modeled after the VAX/VMS program of the same name. The terminal has to be set for 
9600 baud to obtain the proper effect. 


As with all programs that use termcap, the TERM environment variable must be set (and exported) to the 
type of the terminal being used. 


FILES 
/etc/termcap 


AUTHOR 
Eric P. Scott 
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NAME 


robots — fight off villainous robots 


SYNOPSIS 


/usr/games/robots [ -sjta | [ scorefile | 


DESCRIPTION 


Robots pits you against evil robots, who are trying to kill you (which is why they are evil). Fortunately for 
you, even though they are evil, they are not very bright and have a habit of bumping into each other, thus 
destroying themselves. In order to survive, you must get them to kill each other off, since you have no 
offensive weaponry. 


Since you are stuck without offensive weaponry, you are endowed with one piece of defensive weaponry: a 
teleportation device. When two robots run into each other or a junk pile, they die. If a robot runs into you, 
you die. When a robot dies, you get 10 points, and when all the robots die, you start on the next field. This 
keeps up until they finally get you. 


Robots are represented on the screen by a ‘+’, the junk heaps from their collisions by a ‘*’, and you (the 
good guy) by a ‘@’. 


The commands are: 


move one square left 

move one square right 

move one square up 

move one square down 

move one square up and left 

move one square up and right 
move one square down and left 
move one square down and right 

: (also space) do nothing for one turn 
HJKLBNYU run as far as possible in the given direction 
do nothing for as long as possible 
teleport to a random location 

wait until you die or they all do 
quit 

redraw the screen 


posee oer 


me gt 


All commands can be preceded by a count. 


If you use the ‘w’ command and survive to the next level, you will get a bonus of 10% for each robot which 
died after you decided to wait. If you die, however, you get nothing. For all other commands, the program 
will save you from typos by stopping short of being eaten. However, with ‘w’ you take the risk of dying by 
miscalculation. 


Only five scores are allowed per user on the score file. If you make it into the score file, you will be shown 
the list at the end of the game. If an alternate score file is specified, that will be used instead of the standard 
file for scores. 


The options are 
-S Don’t play, just show the score file 


-j Jump, i.e., when you run, don’t show any intermediate positions; only show things at the end. 
This is useful on slow terminals. 


-t Teleport automatically when you have no other option. This is a little disconcerting until you get 
used to it, and then it is very nice. 
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-a Advance into the higher levels directly, skipping the lower, easier levels. 


AUTHOR 
Ken Arnold 


FILES 
/usr/games/lib/robots_roll the score file 


BUGS 
Bugs? You crazy, man?!? 
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NAME 
rogue — Exploring The Dungeons of Doom 


SYNOPSIS 
/usr/games/rogue [ -r ] [ save_file | [ -s ] [-d ] 


DESCRIPTION 
Rogue is a computer fantasy game with a new twist. It is crt oriented and the object of the game is to sur- 
vive the attacks of various monsters and get a lot of gold, rather than the puzzle solving orientation of most 
computer fantasy games. 


To get started you really only need to know two commands. The command ? will give you a list of the 
available commands and the command / will identify the things you see on the screen. 


To win the game (as opposed to merely playing to beat other people’s high scores) you must locate the 
Amulet of Yendor which is somewhere below the 20th level of the dungeon and get it out. Nobody has 
achieved this yet and if somebody does, they will probably go down in history as a hero among heroes. 


When the game ends, either by your death, when you quit, or if you (by some miracle) manage to win, 
rogue will give you a list of the top-ten scorers. The scoring is based entirely upon how much gold you get. 
There is a 10% penalty for getting yourself killed. 


If save_file is specified, rogue will be restored from the specified saved game file. If the -r option is used, 
the save game file is presumed to be the default. 


The —s option will print out the list of scores. 
The —d option will kill you and try to add you to the score file. 
For more detailed directions, read the document A Guide to the Dungeons of Doom. 


AUTHORS 
Michael C. Toy, Kenneth C. R. C. Arnold, Glenn Wichman 


FILES 

/usr/games/lib/rogue roll Score file 

“/rogue.save Default save file 
SEE ALSO 

Michael C. Toy and Kenneth C. R. C. Arnold, A guide to the Dungeons of Doom 
BUGS 


Probably infinite (although countably infinite). However, that Ice Monsters sometimes transfix you perma- 
nently is not a bug. It’s a feature. 
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NAME 


sail — multi-user wooden ships and iron men 


SYNOPSIS 


sail [-s [-1] ] [-x ] [-b] [num ] 


DESCRIPTION 


Sail is a computer version of Avalon Hill’s game of fighting sail originally developed by S. Craig Taylor. 


Players of Sail take command of an old fashioned Man of War and fight other players or the computer. 
They may re-enact one of the many historical sea battles recorded in the game, or they can choose a 
fictional battle. 


As a sea captain in the Sail Navy, the player has complete control over the workings of his ship. He must 
order every maneuver, change the set of his sails, and judge the right moment to let loose the terrible 
destruction of his broadsides. In addition to fighting the enemy, he must harness the powers of the wind 
and sea to make them work for him. The outcome of many battles during the age of sail was decided by the 
ability of one captain to hold the ‘weather gage.’ 


The flags are: 


-Ss Print the names and ships of the top ten sailors. 
- Show the login name. Only effective with -s. 
-x Play the first available ship instead of prompting for a choice. 
—b No bells. 
IMPLEMENTATION 


Sail is really two programs in one. Each player starts up a process which runs his own ship. In addition, a 
driver process is forked (by the first player) to run the computer ships and take care of global bookkeeping. 


Because the driver must calculate moves for each ship it controls, the more ships the computer is playing, 
the slower the game will appear. 


If a player joins a game in progress, he will synchronize with the other players (a rather slow process for 
everyone), and then he may play along with the rest. 


To implement a multi-user game in Version 7 UNIX, which was the operating system Sail was first written 
under, the communicating processes must use a common temporary file as a place to read and write mes- 
sages. In addition, a locking mechanism must be provided to ensure exclusive access to the shared file. For 
example, Sail uses a temporary file named /tmp/#sailsink.21 for scenario 21, and corresponding file names 
for the other scenarios. To provide exclusive access to the temporary file, Sail uses a technique stolen from 
an old game called "pubcaves" by Jeff Cohen. Processes do a busy wait in the loop 


for (n = 0; link(sync_file, sync_lock) < 0 && n < 30; n++) 
sleep(2); 


until they are able to create a link to a file named "/tmp/#saillock.??". The "??" correspond to the scenario 
number of the game. Since UNIX guarantees that a link will point to only one file, the process that suc- 
ceeds in linking will have exclusive access to the temporary file. 


Whether or not this really works is open to speculation. When ucbmiro was rebooted after a crash, the file 
system check program found 3 links between the Sail temporary file and its link file. 


CONSEQUENCES OF SEPARATE PLAYER AND DRIVER 


When players do something of global interest, such as moving or firing, the driver must coordinate the 
action with the other ships in the game. For example, if a player wants to move in a certain direction, he 
writes a message into the temporary file requesting the driver to move his ship. Each ‘“‘turn,’’ the driver 
reads all the messages sent from the players and decides what happened. It then writes back into the 
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temporary file new values of variables, etc. 


The most noticeable effect this communication has on the game is the delay in moving. Suppose a player 
types a move for his ship and hits return. What happens then? The player process saves up messages to be 
written to the temporary file in a buffer. Every 7 seconds or so, the player process gets exclusive access to 
the temporary file and writes out its buffer to the file. The driver, running asynchronously, must read in the 
movement command, process it, and write out the results. This takes two exclusive accesses to the tempo- 
rary file. Finally, when the player process gets around to doing another 7 second update, the results of the 
move are displayed on the screen. Hence, every movement requires four exclusive accesses to the tempo- 
rary file (anywhere from 7 to 21 seconds depending upon asynchrony) before the player sees the results of 
his moves. 


In practice, the delays are not as annoying as they would appear. There is room for "pipelining" in the 
movement. After the player writes out a first movement message, a second movement command can then 
be issued. The first message will be in the temporary file waiting for the driver, and the second will be in 
the file buffer waiting to be written to the file. Thus, by always typing moves a turn ahead of the time, the 
player can sail around quite quickly. 


If the player types several movement commands between two 7 second updates, only the last movement 
command typed will be seen by the driver. Movement commands within the same update "overwrite" each 
other, in a sense. 


THE HISTORY OF SAIL 

I wrote the first version of Sail on a PDP 11/70 in the fall of 1980. Needless to say, the code was horren- 
dous, not portable in any sense of the word, and didn’t work. The program was not very modular and had 
fseeks() and fwrites() every few lines. After a tremendous rewrite from the top down, I got the first work- 
ing version up by 1981. There were several annoying bugs concerning firing broadsides and finding angles. 
Sail uses no floating point, by the way, so the direction routines are rather tricky. Ed Wang rewrote my 
angle() routine in 1981 to be more correct (although it still doesn’t work perfectly), and he added code to let 
a player select which ship he wanted at the start of the game (instead of the first one available). 


Captain Happy (Craig Leres) is responsible for making Sail portable for the first time. This was no easy 
task, by the way. Constants like 2 and 10 were very frequent in the code. I also became famous for using 
"Riggle Memorial Structures" in Sail. Many of my structure references are so long that they run off the line 
printer page. Here is an example, if you promise not to laugh. 


specs[scene[flog.fgamenum].ship[flog.fshipnum].shipnum].pts 


Sail received its fourth and most thorough rewrite in the summer and fall of 1983. Ed Wang rewrote and 
modularized the code (a monumental feat) almost from scratch. Although he introduced many new bugs, 
the final result was very much cleaner and (?) faster. He added window movement commands and find ship 
commands. 


HISTORICAL INFO 
Old Square Riggers were very maneuverable ships capable of intricate sailing. Their only disadvantage 
was an inability to sail very close to the wind. The design of a wooden ship allowed only for the guns to 
bear to the left and right sides. A few guns of small aspect (usually 6 or 9 pounders) could point forward, 
but their effect was small compared to a 68 gun broadside of 24 or 32 pounders. The guns bear approxi- 
mately like so: 


\ up to a range of ten (for round shot) 
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An interesting phenomenon occurred when a broadside was fired down the length of an enemy ship. The 
shot tended to bounce along the deck and did several times more damage. This phenomenon was called a 
rake. Because the bows of a ship are very strong and present a smaller target than the stern, a stern rake 
(firing from the stern to the bow) causes more damage than a bow rake. 


b 
00 ---- Stern rake! 
a 


Most ships were equipped with carronades, which were very large, close range cannons. American ships 
from the revolution until the War of 1812 were almost entirely armed with carronades. 


The period of history covered in Sail is approximately from the 1770’s until the end of Napoleanic France 
in 1815. There are many excellent books about the age of sail. My favorite author is Captain Frederick 
Marryat. More contemporary authors include C.S. Forester and Alexander Kent. 


Fighting ships came in several sizes classed by armament. The mainstays of any fleet were its "Ships of the 
Line", or "Line of Battle Ships". They were so named because these ships fought together in great lines. 
They were close enough for mutual support, yet every ship could fire both its broadsides. We get the mod- 
ern words "ocean liner," or "liner," and "battleship" from "ship of the line." The most common size was the 
the 74 gun two decked ship of the line. The two gun decks usually mounted 18 and 24 pounder guns. 


The pride of the fleet were the first rates. These were huge three decked ships of the line mounting 80 to 
136 guns. The guns in the three tiers were usually 18, 24, and 32 pounders in that order from top to bottom. 


Various other ships came next. They were almost all "razees," or ships of the line with one deck sawed off. 
They mounted 40-64 guns and were a poor cross between a frigate and a line of battle ship. They neither 
had the speed of the former nor the firepower of the latter. 


Next came the "eyes of the fleet." Frigates came in many sizes mounting anywhere from 32 to 44 guns. 
They were very handy vessels. They could outsail anything bigger and outshoot anything smaller. Frigates 
didn’t fight in lines of battle as the much bigger 74’s did. Instead, they harassed the enemy’s rear or cap- 
tured crippled ships. They were much more useful in missions away from the fleet, such as cutting out 
expeditions or boat actions. They could hit hard and get away fast. 


Lastly, there were the corvettes, sloops, and brigs. These were smaller ships mounting typically fewer than 
20 guns. A corvette was only slightly smaller than a frigate, so one might have up to 30 guns. Sloops were 
used for carrying dispatches or passengers. Brigs were something you built for land-locked lakes. 


SAIL PARTICULARS 
Ships in Sail are represented by two characters. One character represents the bow of the ship, and the other 
represents the stern. Ships have nationalities and numbers. The first ship of a nationality is number 0, the 
second number |, etc. Therefore, the first British ship in a game would be printed as "bO". The second Brit 
would be "b1", and the fifth Don would be "s4". 


Ships can set normal sails, called Battle Sails, or bend on extra canvas called Full Sails. A ship under full 
sail is a beautiful sight indeed, and it can move much faster than a ship under Battle Sails. The only trouble 
is, with full sails set, there is so much tension on sail and rigging that a well aimed round shot can burst a 
sail into ribbons where it would only cause a little hole in a loose sail. For this reason, rigging damage is 
doubled on a ship with full sails set. Don’t let that discourage you from using full sails. I like to keep them 
up right into the heat of battle. A ship with full sails set has a capital letter for its nationality. E.g., a Frog, 
"fO", with full sails set would be printed as "FO". 
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When a ship is battered into a listing hulk, the last man aboard "strikes the colors." This ceremony is the 
ship’s formal surrender. The nationality character of a surrendered ship is printed as "!". E.g., the Frog of 
our last example would soon be "!0". 


A ship has a random chance of catching fire or sinking when it reaches the stage of listing hulk. A sinking 
ship has a '"“" printed for its nationality, and a ship on fire and about to explode has a "#" printed. 

Captured ships become the nationality of the prize crew. Therefore, if an American ship captures a British 
ship, the British ship will have an "a" printed for its nationality. In addition, the ship number is changed to 
"e&rrenne sy", "*", or "+" depending upon the original number, be it 0,1,2,3,4, or 5. E.g., the "bO" cap- 
tured by an American becomes the "a&". The "s4" captured by a Frog becomes the "f*". 


The ultimate example is, of course, an exploding Brit captured by an American: "#&". 


MOVEMENT 
Movement is the most confusing part of Sail to many. Ships can head in 8 directions: 


The stern of a ship moves when it turns. The bow remains stationary. Ships can always turn, regardless of 
the wind (unless they are becalmed). All ships drift when they lose headway. If a ship doesn’t move for- 
ward at all for two turns, it will begin to drift. If a ship has begun to drift, then it must move forward before 
it turns, if it plans to do more than make a right or left turn, which is always possible. 


Movement commands to Sail are a string of forward moves and turns. An example is "13". It will turn a 
ship left and then move it ahead 3 spaces. In the drawing above, the "b0O" made 7 successive left turns. 
When Sail prompts you for a move, it prints three characters of import. E.g., 


move (7, 4): 
The first number is the maximum number of moves you can make, including turns. The second number is 
the maximum number of turns you can make. Between the numbers is sometimes printed a quote "’". If 


the quote is present, it means that your ship has been drifting, and you must move ahead to regain headway 
before you turn (see note above). Some of the possible moves for the example above are as follows: 


move (7, 4): 7 

move (7, 4): 1 

move (7, 4): d /* drift, or do nothing */ 
move (7, 4): 6r 

move (7, 4): 5rl 

move (7, 4): 4rlir 

move (7, 4): llr1r2 

move (7, 4): Irlrirl 


Because square riggers performed so poorly sailing into the wind, if at any point in a movement command 
you turn into the wind, the movement stops there. E.g., 


move (7, 4): 1114 
Movement Error; 
Helm: 111 


Moreover, whenever you make a turn, your movement allowance drops to min(what’s left, what you would 


have at the new attitude). In short, if you turn closer to the wind, you most likely won’t be able to sail the 
full allowance printed in the "move" prompt. 
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Old sailing captains had to keep an eye constantly on the wind. Captains in Sail are no different. A ship’s 
ability to move depends on its attitide to the wind. The best angle possible is to have the wind off your 
quarter, that is, just off the stern. The direction rose on the side of the screen gives the possible movements 
for your ship at all positions to the wind. Battle sail speeds are given first, and full sail speeds are given in 
parenthesis. 


0 1(2) 
\I/ 
-"-3(6) 
/\\ 

| 4(7) 
3(6) 
Pretend the bow of your ship (the "*") is pointing upward and the wind is blowing from the bottom to the 
top of the page. The numbers at the bottom "3(6)" will be your speed under battle or full sails in such a sit- 
uation. If the wind is off your quarter, then you can move "4(7)". If the wind is off your beam, "3(6)". If 
the wind is off your bow, then you can only move "1(2)". Facing into the wind, you can’t move at all. 
Ships facing into the wind were said to be "in irons". 


WINDSPEED AND DIRECTION 
The windspeed and direction is displayed as a little weather vane on the side of the screen. The number in 
the middle of the vane indicates the wind speed, and the + to - indicates the wind direction. The wind 
blows from the + sign (high pressure) to the - sign (low pressure). E.g., 


| 
3 


The wind speeds are 0 = becalmed, 1 = light breeze, 2 = moderate breeze, 3 = fresh breeze, 4 = strong 
breeze, 5 = gale, 6 = full gale, 7 = hurricane. If a hurricane shows up, all ships are destroyed. 


GRAPPLING AND FOULING 
If two ships collide, they run the risk of becoming tangled together. This is called "fouling." Fouled ships 
are stuck together, and neither can move. They can unfoul each other if they want to. Boarding parties can 
only be sent across to ships when the antagonists are either fouled or grappled. 


Ships can grapple each other by throwing grapnels into the rigging of the other. 
The number of fouls and grapples you have are displayed on the upper right of the screen. 


BOARDING 
Boarding was a very costly venture in terms of human life. Boarding parties may be formed in Sail to 
either board an enemy ship or to defend your own ship against attack. Men organized as Defensive Board- 
ing Parties fight twice as hard to save their ship as men left unorganized. 


The boarding strength of a crew depends upon its quality and upon the number of men sent. 


CREW QUALITY 
The British seaman was world renowned for his sailing abilities. American sailors, however, were actually 
the best seamen in the world. Because the American Navy offered twice the wages of the Royal Navy, 
British seamen who liked the sea defected to America by the thousands. 


In Sail, crew quality is quantized into 5 energy levels. "Elite" crews can outshoot and outfight all other 
sailors. "Crack" crews are next. "Mundane" crews are average, and "Green" and "Mutinous" crews are 
below average. A good rule of thumb is that "Crack" or "Elite" crews get one extra hit per broadside com- 
pared to "Mundane" crews. Don’t expect too much from "Green" crews. 
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BROADSIDES 
Your two broadsides may be loaded with four kinds of shot: grape, chain, round, and double. You have 
guns and carronades in both the port and starboard batteries. Carronades only have a range of two, so you 
have to get in close to be able to fire them. You have the choice of firing at the hull or rigging of another 
ship. If the range of the ship is greater than 6, then you may only shoot at the rigging. 


The types of shot and their advantages are: 


ROUND 

Range of 10. Good for hull or rigging hits. 
DOUBLE 

Range of 1. Extra good for hull or rigging hits. Double takes two turns to load. 
CHAIN 

Range of 3. Excellent for tearing down rigging. Cannot damage hull or guns, though. 
GRAPE 


Range of 1. Sometimes devastating against enemy crews. 


On the side of the screen is displayed some vital information about your ship: 


Load D! R! 
Hull 9 
Crew 4 4 2 
Guns 4 4 
Carr 2 2 
Rigg 5555 


"Load" shows what your port (left) and starboard (right) broadsides are loaded with. A "!" after the type of 
shot indicates that it is an initial broadside. Initial broadside were loaded with care before battle and before 
the decks ran red with blood. As a consequence, initial broadsides are a little more effective than broad- 
sides loaded later. A "*" after the type of shot indicates that the gun crews are still loading it, and you can- 
not fire yet. "Hull" shows how much hull you have left. "Crew" shows your three sections of crew. As 
your crew dies off, your ability to fire decreases. "Guns" and "Carr" show your port and starboard guns. 
As you lose guns, your ability to fire decreases. "Rigg" shows how much rigging you have on your 3 or 4 
masts. As rigging is shot away, you lose mobility. 


EFFECTIVENESS OF FIRE 

It is very dramatic when a ship fires its thunderous broadsides, but the mere opportunity to fire them does 
not guarantee any hits. Many factors influence the destructive force of a broadside. First of all, and the 
chief factor, is distance. It is harder to hit a ship at range ten than it is to hit one sloshing alongside. Next is 
raking. Raking fire, as mentioned before, can sometimes dismast a ship at range ten. Next, crew size and 
quality affects the damage done by a broadside. The number of guns firing also bears on the point, so to 
speak. Lastly, weather affects the accuracy of a broadside. If the seas are high (5 or 6), then the lower gun- 
ports of ships of the line can’t even be opened to run out the guns. This gives frigates and other flush 
decked vessels an advantage in a storm. The scenario Pellew vs. The Droits de L’Homme takes advantage 
of this peculiar circumstance. 


REPAIRS 
Repairs may be made to your Hull, Guns, and Rigging at the slow rate of two points per three turns. The 
message "Repairs Completed" will be printed if no more repairs can be made. 


PECULIARITIES OF COMPUTER SHIPS 
Computer ships in Sail follow all the rules above with a few exceptions. Computer ships never repair dam- 
age. If they did, the players could never beat them. They play well enough as it is. As a consolation, the 
computer ships can fire double shot every turn. That fluke is a good reason to keep your distance. The 
Driver figures out the moves of the computer ships. It computes them with a typical A.I. distance function 
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and a depth first search to find the maximum "score." It seems to work fairly well, although I'll be the first 
to admit it isn’t perfect. 


HOW TO PLAY 
Commands are given to Sail by typing a single character. You will then be prompted for further input. A 
brief summary of the commands follows. 
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COMMAND SUMMARY 
*f’ Fire broadsides if they bear 
TY Reload 
°L’ Unload broadsides (to change ammo) 
*m’ Move 
*7’ Print the closest ship 
*T’ Print all ships 
°F’ Find a particular ship or ships (e.g. "a?" for all Americans) 
*s’ Send a message around the fleet 
*b’ Attempt to board an enemy ship 
*B’ Recall boarding parties 
°c’ Change set of sail 
r Repair 
w Attempt to unfoul 
g’ Grapple/ungrapple 
v’ Print version number of game 
**L’ Redraw screen 


°Q’ Quit 

°C’ —- Center your ship in the window 
Uv Move window up 

°D’,”N’ Move window down 

-H’ Move window left 

y Move window right 


*S’ Toggle window to follow your ship or stay where it is 


SCENARIOS 
Here is a summary of the scenarios in Sail: 


Ranger vs. Drake: 
Wind from the N, blowing a fresh breeze. 


(a) Ranger 19 gun Sloop (crack crew) (7 pts) 
(b) Drake 17 gun Sloop (crack crew) (6 pts) 


The Battle of Flamborough Head: 
Wind from the S, blowing a fresh breeze. 


This is John Paul Jones’ first famous battle. Aboard the Bonhomme Richard, he was able to overcome the 
Serapis’s greater firepower by quickly boarding her. 


(a) Bonhomme Rich 42 gun Corvette (crack crew) (11 pts) 
(b) Serapis 44 gun Frigate (crack crew) (12 pts) 


Arbuthnot and Des Touches: 
Wind from the N, blowing a gale. 


(b) America 64 gun Ship of the Line (crack crew) (20 pts) 
(b) Befford 74 gun Ship of the Line (crack crew) (26 pts) 
(b) Adamant 50 gun Ship of the Line (crack crew) (17 pts) 
(b) London 98 gun 3 Decker SOL (crack crew) (28 pts) 

(b) Royal Oak 74 gun Ship of the Line (crack crew) (26 pts) 
(f) Neptune 74 gun Ship of the Line (average crew) (24 pts) 
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(f) Duc Bougogne 80 gun 3 Decker SOL (average crew) (27 pts) 
(f) Conquerant 74 gun Ship of the Line (average crew) (24 pts) 
(f) Provence 64 gun Ship of the Line (average crew) (18 pts) 
(f) Romulus 44 gun Ship of the Line (average crew) (10 pts) 


Suffren and Hughes: 
Wind from the S, blowing a fresh breeze. 


(b) Monmouth 74 gun Ship of the Line (average crew) (24 pts) 


(b) Hero 74 gun Ship of the Line (crack crew) (26 pts) 

(b) Isis 50 gun Ship of the Line (crack crew) (17 pts) 

(b) Superb 74 gun Ship of the Line (crack crew) (27 pts) 

(b) Burford 74 gun Ship of the Line (average crew) (24 pts) 
(f) Flamband 50 gun Ship of the Line (average crew) (14 pts) 
(f) Annibal 74 gun Ship of the Line (average crew) (24 pts) 
(f) Severe 64 gun Ship of the Line (average crew) (18 pts) 
(f) Brilliant 80 gun Ship of the Line (crack crew) (31 pts) 

(f) Sphinx 80 gun Ship of the Line (average crew) (27 pts) 


Nymphe vs. Cleopatre: 
Wind from the S, blowing a fresh breeze. 


(b) Nymphe 36 gun Frigate (crack crew) (11 pts) 
(f) Cleopatre 36 gun Frigate (average crew) (10 pts) 


Mars vs. Hercule: 
Wind from the S, blowing a fresh breeze. 
(b) Mars 74 gun Ship of the Line (crack crew) (26 pts) 
(f) Hercule 74 gun Ship of the Line (average crew) (23 pts) 


Ambuscade vs. Baionnaise: 
Wind from the N, blowing a fresh breeze. 


(b) Ambuscade 32 gun Frigate (average crew) (9 pts) 
(f) Baionnaise 24 gun Corvette (average crew) (9 pts) 


Constellation vs. Insurgent: 
Wind from the S, blowing a gale. 


(a) Constellation 38 gun Corvette (elite crew) (17 pts) 
(f) Insurgent 36 gun Corvette (average crew) (11 pts) 


Constellation vs. Vengeance: 
Wind from the S, blowing a fresh breeze. 


(a) Constellation 38 gun Corvette (elite crew) (17 pts) 
(f) Vengeance 40 gun Frigate (average crew) (15 pts) 


The Battle of Lissa: 
Wind from the S, blowing a fresh breeze. 


(b) Amphion 32 gun Frigate (elite crew) (13 pts) 
(b) Active 38 gun Frigate (elite crew) (18 pts) 
(b) Volage 22 gun Frigate (elite crew) (11 pts) 


(b) Cerberus 32 gun Frigate (elite crew) (13 pts) 
(f) Favorite 40 gun Frigate (average crew) (15 pts) 
(f) Flore 40 gun Frigate (average crew) (15 pts) 


4.3 Berkeley Distribution May 6, 1986 


SAIL (6) 


SAIL (6) UNIX Programmer’s Manual 


(f) Danae 40 gun Frigate (crack crew) (17 pts) 
(f) Bellona 32 gun Frigate (green crew) (9 pts) 
(f) Corona 40 gun Frigate (green crew) (12 pts) 


(f) Carolina 32 gun Frigate (green crew) (7 pts) 


Constitution vs. Guerriere: 
Wind from the SW, blowing a gale. 


(a) Constitution 44 gun Corvette (elite crew) (24 pts) 
(b) Guerriere 38 gun Frigate (crack crew) (15 pts) 


United States vs. Macedonian: 
Wind from the S, blowing a fresh breeze. 


(a) United States 44 gun Frigate (elite crew) (24 pts) 
(b) Macedonian 38 gun Frigate (crack crew) (16 pts) 


Constitution vs. Java: 
Wind from the S, blowing a fresh breeze. 


(a) Constitution 44 gun Corvette (elite crew) (24 pts) 
(b) Java 38 gun Corvette (crack crew) (19 pts) 


Chesapeake vs. Shannon: 
Wind from the S, blowing a fresh breeze. 


(a) Chesapeake 38 gun Frigate (average crew) (14 pts) 
(b) Shannon 38 gun Frigate (elite crew) (17 pts) 


The Battle of Lake Erie: 
Wind from the S, blowing a light breeze. 


(a) Lawrence 20 gun Sloop (crack crew) (9 pts) 


(a) Niagara 20 gun Sloop (elite crew) (12 pts) 
(b) Lady Prevost 13 gun Brig (crack crew) (5 pts) 
(b) Detroit 19 gun Sloop (crack crew) (7 pts) 


(b) Q. Charlotte 17 gun Sloop (crack crew) (6 pts) 


Wasp vs. Reindeer: 
Wind from the S, blowing a light breeze. 


(a) Wasp 20 gun Sloop (elite crew) (12 pts) 
(b) Reindeer 18 gun Sloop (elite crew) (9 pts) 


Constitution vs. Cyane and Levant: 
Wind from the S, blowing a moderate breeze. 


(a) Constitution 44 gun Corvette (elite crew) (24 pts) (b) Cyane 


pts) (b) Levant 20 gun Sloop (crack crew) (10 pts) 


Pellew vs. Droits de L’Homme: 
Wind from the N, blowing a gale. 


(b) Indefatigable 44 gun Frigate (elite crew) (14 pts) 
(b) Amazon 36 gun Frigate (crack crew) (14 pts) 


(f) Droits L;7Hom 74 gun Ship of the Line (average crew) (24 pts) 
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Algeciras: 
Wind from the SW, blowing a moderate breeze. 


(b) Caesar 80 gun Ship of the Line (crack crew) (31 pts) 
(b) Pompee 74 gun Ship of the Line (crack crew) (27 pts) 
(b) Spencer 74 gun Ship of the Line (crack crew) (26 pts) 


(b) Hannibal 98 gun 3 Decker SOL (crack crew) (28 pts) 

(s) Real-Carlos 112 gun 3 Decker SOL (green crew) (27 pts) 
(s) San Fernando 96 gun 3 Decker SOL (green crew) (24 pts) 
(s) Argonauta 80 gun Ship of the Line (green crew) (23 pts) 
(s) San Augustine 74 gun Ship of the Line (green crew) (20 pts) 
(f) Indomptable 80 gun Ship of the Line (average crew) (27 pts) 
(f) Desaix 74 gun Ship of the Line (average crew) (24 pts) 


Lake Champlain: 
Wind from the N, blowing a fresh breeze. 


(a) Saratoga 26 gun Sloop (crack crew) (12 pts) 


(a) Eagle 20 gun Sloop (crack crew) (11 pts) 
(a) Ticonderoga 17 gun Sloop (crack crew) (9 pts) 
(a) Preble 7 gun Brig (crack crew) (4 pts) 

(b) Confiance 37 gun Frigate (crack crew) (14 pts) 
(b) Linnet 16 gun Sloop (elite crew) (10 pts) 

(b) Chubb 11 gun Brig (crack crew) (5 pts) 


Last Voyage of the USS President: 
Wind from the N, blowing a fresh breeze. 


(a) President 44 gun Frigate (elite crew) (24 pts) 
(b) Endymion 40 gun Frigate (crack crew) (17 pts) 
(b) Pomone 44 gun Frigate (crack crew) (20 pts) 
(b) Tenedos 38 gun Frigate (crack crew) (15 pts) 


Hornblower and the Natividad: 
Wind from the E, blowing a gale. 


A scenario for you Horny fans. Remember, he sank the Natividad against heavy odds and winds. Hint: 
don’t try to board the Natividad, her crew is much bigger, albeit green. 


(b) Lydia 36 gun Frigate (elite crew) (13 pts) 

(s) Natividad 50 gun Ship of the Line (green crew) (14 pts) 
Curse of the Flying Dutchman: 

Wind from the S, blowing a fresh breeze. 

Just for fun, take the Piece of cake. 

(s) Piece of Cake 24 gun Corvette (average crew) (9 pts) 

(f) Flying Dutchy 120 gun 3 Decker SOL (elite crew) (43 pts) 
The South Pacific: 


Wind from the S, blowing a strong breeze. 


(a) USS Scurvy 136 gun 3 Decker SOL (mutinous crew) (27 pts) 
(b) HMS Tahiti 120 gun 3 Decker SOL (elite crew) (43 pts) 
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(s) Australian 32 gun Frigate (average crew) (9 pts) 
(f) Bikini Atoll 7 gun Brig (crack crew) (4 pts) 


Hornblower and the battle of Rosas 
Wind from the E, blowing a fresh breeze. 


The only battle Hornblower ever lost. He was able to dismast one 
ship and stern rake the others though. See if you can do as well. 


(b) Sutherland 74 gun Ship of the Line (crack crew) (26 pts) 


(f) Turenne 80 gun 3 Decker SOL (average crew) (27 pts) 
(f) Nightmare 74 gun Ship of the Line (average crew) (24 pts) 
(f) Paris 112 gun 3 Decker SOL (green crew) (27 pts) 


(f) Napolean 74 gun Ship of the Line (green crew) (20 pts) 


Cape Horn: 
Wind from the NE, blowing a strong breeze. 


(a) Concord 80 gun Ship of the Line (average crew) (27 pts) 
(a) Berkeley 98 gun 3 Decker SOL (crack crew) (28 pts) 

(b) Thames 120 gun 3 Decker SOL (elite crew) (43 pts) 

(s) Madrid 112 gun 3 Decker SOL (green crew) (27 pts) 

(f) Musket 80 gun 3 Decker SOL (average crew) (27 pts) 


New Orleans: 
Wind from the SE, blowing a fresh breeze. 


Watch that little Cypress go! 


(a) Alligator 120 gun 3 Decker SOL (elite crew) (43 pts) 


(b) Firefly 74 gun Ship of the Line (crack crew) (27 pts) 
(b) Cypress 44 gun Frigate (elite crew) (14 pts) 
Botany Bay: 


Wind from the N, blowing a fresh breeze. 


(b) Shark 64 gun Ship of the Line (average crew) (18 pts) 
(f) Coral Snake 44 gun Corvette (elite crew) (24 pts) 
(f) Sea Lion 44 gun Frigate (elite crew) (24 pts) 


Voyage to the Bottom of the 
Wind from the NW, blowing a fresh breeze. 


This one is dedicated to Richard Basehart and David Hedison. 


(a) Seaview 120 gun 3 Decker SOL (elite crew) (43 pts) 
(a) Flying Sub 40 gun Frigate (crack crew) (17 pts) 
(b) Mermaid 136 gun 3 Decker SOL (mutinous crew) (27 pts) 


(s) Giant Squid 112 gun 3 Decker SOL (green crew) (27 pts) 


Frigate Action: 
Wind from the E, blowing a fresh breeze. 


(a) Killdeer 40 gun Frigate (average crew) (15 pts) 


(b) Sandpiper 40 gun Frigate (average crew) (15 pts) 
(s) Curlew 38 gun Frigate (crack crew) (16 pts) 
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The Battle of Midway: 
Wind from the E, blowing a moderate breeze. 


(a) Enterprise 80 gun Ship of the Line (crack crew) (31 pts) 
(a) Yorktown 80 gun Ship of the Line (average crew) (27 pts) 


(a) Hornet 74 gun Ship of the Line (average crew) (24 pts) 

(j) Akagi 112 gun 3 Decker SOL (green crew) (27 pts) 

(j) Kaga 96 gun 3 Decker SOL (green crew) (24 pts) 

Gj) Soryu 80 gun Ship of the Line (green crew) (23 pts) 
Star Trek: 


Wind from the S, blowing a fresh breeze. 


(a) Enterprise 450 gun Ship of the Line (elite crew) (75 pts) 

(a) Yorktown 450 gun Ship of the Line (elite crew) (75 pts) 
(a) Reliant 450 gun Ship of the Line (elite crew) (75 pts) 

(a) Galileo 450 gun Ship of the Line (elite crew) (75 pts) 

(k) Kobayashi Maru 450 gun Ship of the Line (elite crew) (75 pts) 
(k) Klingon IT 450 gun Ship of the Line (elite crew) (75 pts) 

(0) Red Orion 450 gun Ship of the Line (elite crew) (75 pts) 
(0) Blue Orion 450 gun Ship of the Line (elite crew) (75 pts) 


CONCLUSION 
Sail has been a group effort. 


Ken Arnold Code 
curses library (pu!) 


AUTHOR 
Dave Riggle 


CO-AUTHOR 
Ed Wang 


REFITTING 
Craig Leres 


CONSULTANTS 
Chris Guthrie 
Captain Happy 
Horatio Nelson 
Nancy Reagan 
and many valiant others... 


REFERENCES 
Wooden Ships & Iron Men, by Avalon Hill 
Captain Horatio Hornblower Novels, (13 of them) by C.S. Forester 
Captain Richard Bolitho Novels, (12 of them) by Alexander Kent 
The Complete Works of Captain Frederick Marryat, (about 20) especially 
Mr. Midshipman Easy 
Peter Simple 
Jacob Faithful 
Japhet in Search of a Father 
Snarleyyow, or The Dog Fiend 
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Frank Mildmay, or The Naval Officer 


SEE ALSO 
midway(PUBLIC) 


BUGS 
Probably a few, and please report them to "riggle@ernie" and "edward @arpa." 
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NAME 


snake, snscore — display chase game 


SYNOPSIS 


/usr/games/snake [ —wn |] [ -In | 
/usr/games/snscore 


DESCRIPTION 


FILES 


BUGS 


Snake is a display-based game which must be played on a CRT terminal from among those supported by 
vi(1). The object of the game is to make as much money as possible without getting eaten by the snake. 
The —I and —w options allow you to specify the length and width of the field. By default the entire screen 
(except for the last column) is used. 


You are represented on the screen by an I. The snake is 6 squares long and is represented by S’s. The 
money is $, and an exit is #. Your score is posted in the upper left hand corner. 


You can move around using the same conventions as vi(1), the h, j, k, and 1 keys work, as do the arrow 
keys. Other possibilities include: 


sefc These keys are like hjkl but form a directed pad around the d key. 


HJKL These keys move you all the way in the indicated direction to the same row or column as the 
money. This does not let you jump away from the snake, but rather saves you from having to type 
a key repeatedly. The snake still gets all his turns. 


SEFC Likewise for the upper case versions on the left. 


ATPB_ These keys move you to the four edges of the screen. Their position on the keyboard is the 
mnemonic, e.g. P is at the far right of the keyboard. 


X This lets you quit the game at any time. 

p Points in a direction you might want to go. 

Ww Space warp to get out of tight squeezes, at a price. 

! Shell escape 

°Z Suspend the snake game, on systems which support it. Otherwise an interactive shell is started up. 


To earn money, move to the same square the money is on. A new $ will appear when you earn the current 
one. As you get richer, the snake gets hungrier. To leave the game, move to the exit (#). 


A record is kept of the personal best score of each player. Scores are only counted if you leave at the exit, 
getting eaten by the snake is worth nothing. 


As in pinball, matching the last digit of your score to the number which appears after the game is worth a 
bonus. 


To see who wastes time playing snake, run /usr/games/snscore . 


/ustr/games/lib/snakerawscores database of personal bests 
/usr/games/lib/snake.log log of games played 
/usr/games/busy program to determine if system too busy 


When playing on a small screen, it’s hard to tell when you hit the edge of the screen. 


The scoring function takes into account the size of the screen. A perfect function to do this equitably has 
not been devised. 
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NAME 
trek — trekkie game 


SYNOPSIS 
/usr/games/trek [ [ —a ] file ] 


DESCRIPTION 
Trek is a game of space glory and war. Below is a summary of commands. For complete documentation, 
see Trek by Eric Allman. 


If a filename is given, a log of the game is written onto that file. If the —a flag is given before the filename, 
that file is appended to, not truncated. 


6eé 99 66 


The game will ask you what length game you would like. Valid responses are “‘short’’, ‘‘medium’’, and 
“‘long’’. You may also type ‘‘restart’’, which restarts a previously saved game. You will then be prompted 
for the skill, to which you must respond ‘‘novice’’, ‘‘fair’’, ‘“good’’, “‘expert commadore’’, or ‘‘impos- 


sible’’. You should normally start out with a novice and work up. 


99 66 
e) 


In general, throughout the game, if you forget what is appropriate the game will tell you what it expects if 
you just type in a question mark. 


AUTHOR 
Eric Allman 
SEE ALSO 
/usr/doc/trek 
COMMAND SUMMARY 
abandon capture 
cloak up/down 
computer request; ... damages 
destruct dock 
help impulse course distance 
Irscan move course distance 


phasers automatic amount 
phasers manual amt! course! spread 1 ... 
torpedo course [yes] angle/no 


ram course distance rest time 

shell shields up/down 
srscan [yes/no] 

status terminate yes/no 
undock visual course 


warp warp_ factor 
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NAME 
worm — Play the growing worm game 


SYNOPSIS 
/usr/games/worm [ size | 

DESCRIPTION 
In worm, you are a little worm, your body is the "o"’s on the screen and your head is the "@". You move 
with the hjkl keys (as in the game snake). If you don’t press any keys, you continue in the direction you 
last moved. The upper case HJKL keys move you as if you had pressed several (9 for HL and 5 for JK) of 
the corresponding lower case key (unless you run into a digit, then it stops). 


On the screen you will see a digit, if your worm eats the digit is will grow longer, the actual amount longer 
depends on which digit it was that you ate. The object of the game is to see how long you can make the 
worm grow. 


The game ends when the worm runs into either the sides of the screen, or itself. The current score (how 
much the worm has grown) is kept in the upper left corner of the screen. 


The optional argument, if present, is the initial length of the worm. 


BUGS 
If the initial length of the worm is set to less than one or more than 75, various strange things happen. 
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NAME 

worms — animate worms on a display terminal 
SYNOPSIS 

/usr/games/worms [ -field | [ -length # | [ -number # ] [ -trail ] 
DESCRIPTION 


Brian Horn (cithep!bdh) showed me a TOPS-20 program on the DEC-2136 machine called WORM, and 
suggested that I write a similar program that would run under Unix. I did, and no apologies. 


-field makes a "field" for the worm(s) to eat; —-trail causes each worm to leave a trail behind it. You can 
figure out the rest by yourself. 


FILES 
/etc/termcap 


AUTHOR 
Eric P. Scott 


SEE ALSO 
Snails , by Karl Heuer 


BUGS 
The lower-right-hand character position will not be updated properly on a terminal that wraps at the right 
margin. 


Terminal initialization is not performed. 
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NAME 
wump — the game of hunt-the-wumpus 


SYNOPSIS 
/usr/games/wump 


DESCRIPTION 
Wump plays the game of ‘Hunt the Wumpus.’ A Wumpus is a creature that lives in a cave with several 
rooms connected by tunnels. You wander among the rooms, trying to shoot the Wumpus with an arrow, 
meanwhile avoiding being eaten by the Wumpus and falling into Bottomless Pits. There are also Super 
Bats which are likely to pick you up and drop you in some random room. 


The program asks various questions which you answer one per line; it will give a more detailed description 
if you want. 


This program is based on one described in People’s Computer Company, 2, 2 (November 1973). 
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NAME 
zork — the game of dungeon 


SYNOPSIS 
/usr/games/zork 


DESCRIPTION 
Dungeon is a computer fantasy simulation based on Adventure and on Dungeons & Dragons, originally 
written by Lebling, Blank, and Anderson of MIT. In it you explore a dungeon made up of various rooms, 
caves, rivers, and so on. The object of the game is to collect as much treasure as possible and stow it safely 
in the trophy case (and, of course, to stay alive.) 


Figuring out the rules is part of the game, but if you are stuck, you should start off with “‘open mailbox’’, 
“‘take leaflet’’, and then ‘‘read leaflet’’. Additional useful commands that are not documented include: 


quit (to end the game) 


‘cmd (the usual shell escape convention) 


> (to save a game) 

< (to restore a game) 
FILES 

/usr/games/lib/d* 
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NAME 
miscellaneous — miscellaneous useful information pages 
DESCRIPTION 
This section contains miscellaneous documentation, mostly in the area of text processing macro packages 
for troff(1). 
ascii map of ASCII character set 
environ user environment 
eqnchar special character definitions for eqn 
hier file system hierarchy 
mailaddr mail addressing description 
man macros to typeset manual pages 
me macros for formatting papers 
ms macros for formatting manuscripts 
term conventional names for terminals 
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NAME 
ascii — map of ASCII character set 


SYNOPSIS 
cat /usr/pub/ascii 


DESCRIPTION 
Ascii is a map of the ASCII character set, to be printed as needed. It contains: 


1000 nul|001 soh|002 stxl003 etx|004 eot|005 enq|006 ack|007 bell 
1010 bs [011 ht [012 nl [013 vt 1014 np 1015 cr |016 so [017 si | 
1020 dle|021 dc1|022 de2|023 dce3|024 dc4|025 nak|026 syn|027 etbl 
1030 can|031 em |032 sub|033 escl034 fs 1035 gs 1036 rs |037 us 


| 
1040 sp 1041 ! 1042 " 1043 # 1044 $ 1045 % 1046 & 1047 ~ 
1050 ( 1051 ) 1052 * 1053 + 1054 , 1055 - 1056 . 1057 / | 
1060 0 1061 1 1062 2 1063 3 1064 4 1065 5 1066 6 |067 7 | 
1070 8 1071 9 1072 : 1073 ; 1074 < 1075 = 1076 > 1077 2 | 
1100 @ |101 A 1/102 B 1103 C1104 D 1105 E |106 F 1/107 G | 
1110 Hl111 1 1112 J 1113 K 1/114 L 1115 M1116 N 1/117 O| 
1120 P l121 Q 1/122 R 1123 S 1124 T 1125 U 1126 Vv 1127 wl 
1130 xX [131 Y 1132 Z 1133. [ [134 \ 1135 ] 1136 * [137 _ | 
1140 * [141 a 1142 b 1143 c 1144 d 1145 e |146 f£ 1147 g | 
1150 h 1151 i 1152 j 1153 k 1154 1 [155 m|156 n |157 0 | 
1160 p 1161 q 1162 r 1163 s 1164 t 1165 wu 1166 v 1167 w | 
1170 x 1171 y 1172 z 1173 ¢ 1174 | 1175 } 1176 ~ 1177 dell 


00 nul| 01 soh| 02 stx| 03 etx! 04 eot| 05 enq| 06 ack! 07 bell 
08 bs | 09 ht | Oa nl | Ob vt | Oc np | Od cr | Oe so | OF si | 
10 dle| 11 del] 12 de2| 13 de3| 14 de4| 15 nak| 16 syn| 17 etbl 


| 
| 
| 
| 18 can| 19 em | 1a subl 1b escl Ic fs | 1d gs | le rs | 1f us | 
['20:sp (2b 2 | 22 2a | BA Bl) 5-6. ok | 27 
[ide ee aor 3 [eae se OB ae Ie 1 ods aaa oe | 2e 7 | 
| 30 o | 31 1/32 2133 3/134 4135 5 | 36 6/137 7 | 
| 38 8 | 39 9 | 3a : | 3b ; | 3c < | 3d =| 3e >| 3f 2 | 
| 40 @| 41 Al 42 BI 43 Cl 44 DI 45 E| 46 F| 47 Gl 
| 48 H| 49 I | 4a J | 4b KI 4c LI 4d M| 4e N| 4f O| 
[50 “P| S14. -O-1 52 Ro) 53° S| 64 oT) SS ar 56 vo 57: wl 
[58° SO: ee hae 2 5b eee MANS OD li-Sex aE | 
| 60 > | 61 al 62 bI| 63 c | 64 d|65 e | 6 £1! 67 gi 
| 68 hl 69 il 6a j | 6 k I 6c 1 | 6d m| 6 n| 6f o | 
I FO: espe ra age | Oe aes lies ge ae eas al AG oye ATT ae | 
78s x 79 yl a, oe | be OL pee ds OR ee Tt det | 
FILES 
/usr/pub/ascii 
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NAME 
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environ — user environment 


SYNOPSIS 


extern char **environ; 


DESCRIPTION 


An array of strings called the ‘environment’ is made available by execve(2) when a process begins. By 
convention these strings have the form ‘name=value’. The following names are used by various com- 


mands: 


PATH 


HOME 
TERM 


SHELL 


TERMCAP 


EXINIT 
USER 


The sequence of directory prefixes that sh, time, nice(1), etc., apply in searching for a file 
known by an incomplete path name. The prefixes are separated by ‘:’. Login(1) sets 
PATH=:/usr/ucb:/bin:/usr/bin. 


A user’s login directory, set by /ogin(1) from the password file passwd (5). 


The kind of terminal for which output is to be prepared. This information is used by com- 
mands, such as nroff or plot(1G), which may exploit special terminal capabilities. See 
/etc/termcap (termcap(5)) for a list of terminal types. 


The file name of the users login shell. 


The string describing the terminal in TERM, or the name of the termcap file, see 
termcap(5),termcap (3X). 


A Startup list of commands read by ex(1), edit(1), and vi(1). 


The login name of the user. 


PRINTER The name of the default printer to be used by /pr(1), [pg(1), and Iprm(1). 


Further names may be placed in the environment by the export command and ‘name=value’ arguments in 
sh(1), or by the setenv command if you use csh(1). Arguments may also be placed in the environment at 
the point of an execve(2). It is unwise to conflict with certain sh(1) variables that are frequently exported 
by ‘.profile’ files: MAIL, PS1, PS2, IFS. 


SEE ALSO 


csh(1), ex(1), login(1), sh(1), execve(2), system(3), termcap(3X), termcap(5) 


4.2 Berkeley Distribution May 20, 1985 1 


EQNCHAR (7) UNIX Programmer’s Manual EQNCHAR (7 ) 


NAME 


tdefine ciplus % "®" % ndefine ciplus % G+ % tdefine citimes % "®" % ndefine citimes % Ok % tdefine 
=wig % "=" % ndefine =wig % =" % tdefine bigstar % "x" % ndefine bigstar % Xt % tdefine =dot % "=" 
% ndefine =dot % = dot % tdefine orsign % "V" % ndefine orsign % V % tdefine andsign % "A" % ndefine 
andsign % /\ % tdefine =del % "A" % ndefine =del % = to DELTA % tdefine oppA % "V" % ndefine oppA 
% “- % tdefine oppE %"3" % ndefine oppE % H % tdefine incl % "[_" % ndefine incl % C_ % tdefine 
nomem % "é" % ndefine nomem % CG % tdefine angstrom % "A" % ndefine angstrom % A to o % tdefine 
star %{ roman ",,"}% ndefine star % * % tdefine || % || % tdefine <wig % "<" % ndefine <wig %{ < from 
"™" \% tdefine >wig % ">" % ndefine >wig %{ > from "~" }% tdefine langle % : " % ndefine langle %<% 
tdefine rangle % a % ndefine rangle %>% tdefine hbar % "h" % ndefine hbar % ‘i % ndefine ppd % ‘| % 
tdefine ppd % me % tdefine <-> % "<>" % ndefine <-> % "<-->" % tdefine <=> % "<=" % ndefine <=> % 
"<=>" % tdefine |< % "{" % ndefine |< % 4 % tdefine |> % "}" % ndefine |> % b % tdefine ang % "/" 
% ndefine ang % / % tdefine rang % "|_" % ndefine rang % L % tdefine 3dot % "" % ndefine 3dot % : % 
tdefine thf % ".°." % ndefine thf % .: % tdefine quarter % roman “% % ndefine quarter % 1/4 % tdefine 
3quarter % roman % % ndefine 3quarter % 3/4 % tdefine degree % ° % ndefine degree % nothing sup o e 
tdefine square % 0 % ndefine square % [] % tdefine circle % © % ndefine circle % O % tdefine blot % " 
% ndefine blot % HX % tdefine bullet % © % ndefine bullet % oe % tdefine -wig % "=" % ndefine -wig % - 
to" % tdefine wig % ~ % ndefine wig % "~" % tdefine prop % ~« % ndefine prop % oc % tdefine empty % 
© % ndefine empty % O % tdefine member % € % ndefine member % G % tdefine cup % U % ndefine cup 
% U % define cap % M % define subset % C % define supset % > % define !subset % Cc % define !supset 
% D% 


eqnchar — special character definitions for eqn 


SYNOPSIS 


eqn /usr/pub/eqnchar [ files | | troff [ options ] 


neqn /usr/pub/eqnchar [ files | | nroff [ options ] 


DESCRIPTION 


Egqnchar contains troff and nroff character definitions for constructing characters that are not available on 
the Graphic Systems typesetter. These definitions are primarily intended for use with eqn and neqn. It con- 
tains definitions for the following characters 


"ciplus" ciplus maf | | "square" square 
"citimes" citimes "langle" langle "circle" circle 
"wig" wig "rangle" rangle "plot" blot 
"-wig" — -wig "hbar" —shbar "bullet" bullet 
"S>wig" >wig "ppd" ppd "prop" — prop 
"<wig" <wig "<->" <-> "empty" empty 
"=wig" =wig "<=>" <=> "member" member 
"star" star ples |< "nomem" nomem 
"pigstar" bigstar Hist |> "cup" cup 
"=dot" =dot "ang" ang "cap" cap 
"orsign" orsign "rang" rang "incl" incl 
"andsign" andsign "3dot" 3dot "subset" subset 
"=del" = =del "thf" thf "supset" supset 
"oppA" oppA "quarter" quarter "Isubset" !subset 
"oppE" oppE "3quarter" 3quarter "Isupset"” !supset 
"angstrom" angstrom "degree" degree 

FILES 
/ust/pub/eqnchar 

SEE ALSO 


troff(1), eqn(1) 
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NAME 
hier — file system hierarchy 
DESCRIPTION 
The following outline gives a quick tour through a representative directory hierarchy. 
/ root 
/vmunix 
the kernel binary (UNIX itself) 
/ost+found 
directory for connecting detached files for fsck(8) 
/dev/ devices (4) 
MAKEDEV 
shell script to create special files 
MAKEDEV local 
site specific part of MAKEDEV 
console main console, tty(4) 
tty* terminals, tty (4) 
hp* disks, hp(4) 
rhp* raw disks, hp (4) 
up* UNIBUS disks up(4) 
/bin/ utility programs, cf /usr/bin/ (1) 
as assembler 
cc C compiler executive, cf /lib/ccom, /lib/cpp, /lib/c2 
csh C shell 
/ib/ object libraries and other stuff, cf /usr/lib/ 
libc.a system calls, standard I/O, etc. (2,3,3S) 
ccom C compiler proper 
cpp C preprocessor 
c2 C code improver 
/etc/ essential data and maintenance utilities; sect (8) 


dump dump program dump(8) 
passwd password file, passwd(5) 
group group file, group(5) 
motd message of the day, login(1) 
termcap description of terminal capabilities, termcap(5) 
ttytype table of what kind of terminal is on each port, ttytype(5) 
mtab mounted file table, mtab(5) 
dumpdates 
dump history, dump(8) 
fstab _ file system configuration table fstab (5) 
disktab disk characteristics and partition tables, disktab(5) 
hosts host name to network address mapping file, hosts (5) 
networks 
network name to network number mapping file, networks (5) 
protocols 
protocol name to protocol number mapping file, protocols (5) 
services network services definition file, services(5) 
remote names and description of remote hosts for tip(1C), remote (5) 
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phones private phone numbers for remote hosts, as described in phones(5) 
ttys properties of terminals, ttys(5) 

getty _ part of login, getty(8) 

init the parent of all processes, init(8) 

rc shell program to bring the system up 

rc.local site dependent portion of rc 

cron the clock daemon, cron(8) 

mount mount(8) 


/sys/ system source 
h/ header (include) files 
acct.h acct(5) 
stat.h — stat(2) 


sys/ machine independent system source 
init_main.c 
uipc_socket.c 
ufs_syscalls.c 


conf/ site configuration files 
GENERIC 


net/ general network source 
netinet/ DARPA Internet network source 
netimp/ network code related to use of an IMP 
if_imp.c 
if_imphost.c 
if _imphost.h 


vax/ source specific to the VAX 
locore.s 
machdep.c 


vaxuba/ device drivers for hardware which resides on the UNIBUS 
uba.c 
dh.c 
up.c 


vaxmba/ 
device drivers for hardware which resides on the MASBUS 
mba.c 
hp.c 
ht.c 


vaxif network interface drivers for the VAX 
if en.c 
if_ec.c 
if _vv.c 


/tmp/ temporary files, usually on a fast device, cf /usr/tmp/ 
e* used by ed(1) 
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ctm* 
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used by cc(1) 


/ust/ general-pupose directory, usually a mounted file system 
administrative information 


adm/ 


/usr /bin 


wtmp login history, utmp(5) 
messages 
hardware error messages 
tracct phototypesetter accounting, troff(1) 
Ipacct _ line printer accounting /pr(1) 


vaacct, vpacct 


varian and versatec accounting vpr(1), vtroff(1), pac(8) 


utility programs, to keep /bin/ small 
temporaries, to keep /tmp/ small 


tmp/ 


dict/ 


games/ 


stm* 
raster 


used by sort(1) 
used by plot(1G) 


word lists, etc. 


words 


spellhist 


principal word list, used by look(1) 


history file for spell(1) 


hangman 


lib/ 


library of stuff for the games 
quiz.k/ what quiz(6) knows 
index category index 
africa countries and capitals 


include/ standard #include files 


lib/ 
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a.out.h 
stdio.h 
math.h 
sys/ 
net/ 


object file layout, a.out(5) 
standard I/O, intro (3S) 
(3M) 


system-defined layouts, cf /sys/h 
symbolic link to sys/net 


machine/ 


symbolic link to sys/machine 


object libraries and stuff, to keep /lib/ small 


atrun 
lint/ 


struct/ 


tmac/ 


scheduler for at(1) 
utility files for lint 
lint{12] subprocesses for lint(1) 


llib-lc dummy declarations for /lib/libc.a, used by lint(1) 


llib-Im dummy declarations for /lib/libc.m 
passes of struct(1) 
macros for troff(1) 


tmac.an macros for man(7) 
tmac.s macros for ms(7) 
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/ust/ man/ 


font/ 


uucp/ 


units 
eign 
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fonts for troff(1) 
ftR Times Roman 


ftB Times Bold 


programs and data for uucp(1C) 
L.sys remote system names and numbers 
uucico the real copy program 


conversion tables for units (1) 
list of English words to be ignored by ptx(1) 


volume | of this manual, man(1) 


msgs/ 


new/ 


spool/ 
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man0O/ 


man1/ 


catl/ 


general 

intro introduction to volume 1, ms(7) format 
XX template for manual page 

chapter | 

as.1 

mount. 1m 


preformatted pages for section | 


messages, cf msgs (1) 

bounds highest and lowest message 
binaries of new versions of programs 
preserve/ 
editor temporaries preserved here after crashes/hangups 
public/ binaries of user programs - write permission to everyone 
delayed execution files 


at/ 
Ipd/ 


uucp/ 


mail/ 


used by at(1) 
used by /pr(1) 
lock present when line printer is active 
cf* copy of file to be printed, if necessary 
df* daemon control file, [pd(8) 
tf* transient control file, while /pr is working 
work files and staging area for uucp(1C) 
LOGFILE 
summary log 
LOG.* log file for one transaction 
mailboxes for mail(1) 
name mail file for user name 
name .lock 
lock file while name is receiving mail 


secretmail/ 


uucp/ 


like mail/ 
work files and staging area for uucp(1C) 
LOGFILE 

summary log 
LOG.* log file for one transaction 
mqueue/ 

mail queue for sendmail (8) 
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wd initial working directory of a user, typically wd is the user’s login name 
-profile set environment for sh(1), environ(7) 
-project what you are doing (used by ( finger(1) ) 
-cshre _ startup file for csh(1) 
EXC startup file for ex(1) 
-plan what your short-term plans are (used by finger(1) ) 
netrc startup file for various network programs 
-msgsrc startup file for msgs(1) 
-mailre startup file for mail(1) 
calendar 
user’s datebook for calendar(1) 
doc/ papers, mostly in volume 2 of this manual, typically in ms(7) format 
as/ assembler manual 
c C manual 


/ast/ src/ 
source programs for utilities, etc. 


bin/ source of commands in /bin 
as/ assembler 
ar.c source for ar(1) 


usr.bin/ source for commands in /usr/bin 
troff/ source for nroff and troff(1) 
font/ source for font tables, /usr/lib/font/ 
ftR.c Roman 


term/ terminal characteristics tables, /usr/lib/term/ 


tab300.c 
DASI 300 
ucb source for programs in /usr/ucb 
games/ source for /usr/games 
lib/ source for programs and archives in /lib 
libc/ C runtime library 
csu/ startup and wrapup routines needed with every C program 


crt0.s regular startup 

mert0.s modified startup for cc —p 
sys/ system calls (2) 

access.S 

brk.s 


stdio/ standard I/O functions (3S) 
fgets.c 


fopen.c 


gen/ other functions in (3) 
abs.c 


net/ network functions in (3N) 
gethostbyname.c 
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HIER (7) 
local/ 
new/ 
old/ 
ucb/ 
SEE ALSO 


Is(1), apropos(1), whatis(1), whereis(1), finger(1), which(1), ncheck(8), find(1), grep(1) 


BUGS 


UNIX Programmer’s Manual 


source which isn’t normally distributed 

source for new versions of commands and library routines 
source for old versions of commands and library routines 
binaries of programs developed at UCB 


edit editor for beginners 
ex command editor for experienced users 


mail mail reading/sending subsystem 


man on line documentation 
pi Pascal translator 

px Pascal interpreter 

vi visual editor 


The position of files is subject to change without notice. 
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NAME 
mailaddr — mail addressing description 


DESCRIPTION 
Mail addresses are based on the ARPANET protocol listed at the end of this manual page. These addresses 
are in the general format 


user @domain 
where a domain is a hierarchical dot separated list of subdomains. For example, the address 
eric @monet.Berkeley. ARPA 


is normally interpreted from right to left: the message should go to the ARPA name tables (which do not 
correspond exactly to the physical ARPANET), then to the Berkeley gateway, after which it should go to 
the local host monet. When the message reaches monet it is delivered to the user ‘‘eric’’. 


Unlike some other forms of addressing, this does not imply any routing. Thus, although this address is 
specified as an ARPA address, it might travel by an alternate route if that were more convenient or efficient. 
For example, at Berkeley the associated message would probably go directly to monet over the Ethernet 
rather than going via the Berkeley ARPANET gateway. 


Abbreviation. 


Under certain circumstances it may not be necessary to type the entire domain name. In general anything 
following the first dot may be omitted if it is the same as the domain from which you are sending the mes- 
sage. For example, a user on ‘‘calder.Berkeley. ARPA’’ could send to “‘eric@monet’’ without adding the 
“* Berkeley.ARPA”’ since it is the same on both sending and receiving hosts. 


Certain other abbreviations may be permitted as special cases. For example, at Berkeley ARPANET hosts 
can be referenced without adding the ‘‘.ARPA’’ as long as their names do not conflict with a local host 
name. 


Compatibility. 


Certain old address formats are converted to the new format to provide compatibility with the previous mail 
system. In particular, 


host:user 
is converted to 
user @host 
to be consistent with the rcp(1C) command. 
Also, the syntax: 
host!user 
is converted to: 
user @host. UUCP 


This is normally converted back to the ‘‘host!user’’ form before being sent on for compatibility with older 
UUCP hosts. 


The current implementation is not able to route messages automatically through the UUCP network. Until 
that time you must explicitly tell the mail system which hosts to send your message through to get to your 
final destination. 


Case Distinctions. 


Domain names (i.e., anything after the ‘‘@’’ sign) may be given in any mixture of upper and lower case 
with the exception of UUCP hostnames. Most hosts accept any combination of case in user names, with 
the notable exception of MULTICS sites. 
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Differences with ARPA Protocols. 


Although the UNIX addressing scheme is based on the ARPA mail addressing protocols, there are some 
significant differences. 


At the time of this writing DARPA is converting to real domains. The following rules may be useful: 


e The syntax ‘‘user@host.ARPA”’ is being split up into ‘‘user@host.COM’’, ‘‘user@host.GOV’’, and 
“‘user@host.EDU”’ for commercial, government, and educational institutions respectively. 


e The syntax “‘user@host’’ (with no dots) has traditionally referred to the ARPANET. In the future this 
semantic will not be continued — instead, the host will be assumed to be in your organization. You should 
start using one of the syntaxes above. 


e Host names of the form ‘‘ORG-NAME”’ (e.g., MIT-MC or CMU-CS-A) will be changing to 
““NAME.ORG.XXX’’ (where ‘XXX’ is COM, GOV, or EDU). For example, MIT-MC will change to 
MC.MIT.EDU. In some cases names will be split apart even if they do not have dashes. For example, 
USC-ISIF will probably change to F.ISI.USC.EDU. 


Route-addrs. 


Under some circumstances it may be necessary to route a message through several hosts to get it to the final 
destination. Normally this routing is done automatically, but sometimes it is desirable to route the message 
manually. Addresses which show these relays are termed ‘‘route-addrs.’’ These use the syntax: 


<@hosta, @ hostb:user @hostc> 


This specifies that the message should be sent to hosta, from there to hostb, and finally to hostc. This path 
is forced even if there is a more efficient path to hostc. 


Route-addrs occur frequently on return addresses, since these are generally augmented by the software at 
each host. It is generally possible to ignore all but the “‘user@host’’ part of the address to determine the 
actual sender. 


Postmaster. 


Every site is required to have a user or user alias designated ‘‘postmaster’’ to which problems with the mail 
system may be addressed. 


Other Networks. 


Some other networks can be reached by giving the name of the network as the last component of the 
domain. This is not a standard feature and may not be supported at all sites. For example, messages to 
CSNET or BITNET sites can often be sent to ‘“‘user@host.CSNET”’ or ‘‘user@host.BITNET’’ respec- 
tively. 


BERKELEY 
The following comments apply only to the Berkeley environment. 


What’s My Address? 
If you are on a local machine, say monet, your address is 
yourname @ monet.Berkeley.ARPA 


However, since most of the world does not have the new software in place yet, you will have to give corre- 
spondents slightly different addresses. From the ARPANET, your address would be: 


yourname% monet @Berkeley. ARPA 
From UUCP, your address would be: 


ucbvax!yourname%monet 
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Computer Center. 


The Berkeley Computer Center is in a subdomain of Berkeley. Messages to the computer center should be 
addressed to: 


user%host.CC @ Berkeley. ARPA 
The alternate syntax: 
user @host.CC 
may be used if the message is sent from inside Berkeley. 


For the time being Computer Center hosts are known within the Berkeley domain, i.e., the ‘*.CC’’ is 
optional. However, it is likely that this situation will change with time as both the Computer Science 
department and the Computer Center grow. 


a The RFC822 group syntax (‘‘group:userl,user2,user3;’’) is not supported except in the special case of 
““sroup:;’’ because of a conflict with old berknet-style addresses. 
Route-Address syntax is grotty. 
UUCP- and ARPANET-style addresses do not coexist politely. 

SEE ALSO 


mail(1), sendmail(8); Crocker, D. H., Standard for the Format of Arpa Internet Text Messages, RFC822. 


4.2 Berkeley Distribution May 6, 1986 3 


MAN (7) UNIX Programmer’s Manual MAN (7) 


NAME 


man — macros to typeset manual 


SYNOPSIS 


nroff —man file ... 


troff -man file ... 


DESCRIPTION 


These macros are used to lay out pages of this manual. A skeleton page may be found in the file 
/usr/man/man0/xx. 


Any text argument ¢ may be zero to six words. Quotes may be used to include blanks in a ‘word’. If text is 
empty, special treatment is applied to the next input line with text to be printed. In this way .I may be used 
to italicize a whole line, or .SM may be followed by .B to make small bold letters. 


A prevailing indent distance is remembered between successive indented paragraphs, and is reset to default 
value upon reaching a non-indented paragraph. Default units for indents i are ens. 


Type font and size are reset to default values before each paragraph, and after processing font and size set- 
ting macros. 


These strings are predefined by —man: 
\*R ‘®’, ‘(Reg)’ in nroff. 
\*S Change to default type size. 


FILES 

/usr/lib/tmac/tmac.an 

/usr/man/man0/xx 
SEE ALSO 

troff(1), man(1) 
BUGS 

Relative indents don’t nest. 
REQUESTS 
Request Cause If no Explanation 

Break Argument 
Bt no f=n.tjl.* Text tis bold. 
.BIt no f=n.t.l. Join words of ¢ alternating bold and italic. 
.BRt no f=n.t.l. Join words of ¢ alternating bold and Roman. 
.DT no .di li... Restore default tabs. 
-HP i yes i=p.i.* Set prevailing indent to 7. Begin paragraph with hanging indent. 
It no f=ntl. Text ris italic. 
Bt no f=n.t.l. Join words of ¢ alternating italic and bold. 
AP xi yes) x=" Same as .TP with tag x. 
AR t no f=n.t.l. Join words of ¢ alternating italic and Roman. 
.LP yes - Same as .PP. 
PD d no d=4v Interparagraph distance is d. 
.PP yes - Begin paragraph. Set prevailing indent to .5i. 
.RE yes - End of relative indent. Set prevailing indent to amount of starting .RS. 
-RB t no f=n.t.l. Join words of ¢ alternating Roman and bold. 
RI t no f=n.t.l. Join words of ¢ alternating Roman and italic. 
-RS i yes i=p.i. Start relative indent, move left margin in distance i. Set prevailing indent to .5i for 
nested indents. 

SH t yes f=n.t.. Subhead. 
SM t no f=ntl. Text tis small. 
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.TH nc xv myes 


.TP i 


yes 


i=p.i. 
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Begin page named n of chapter c; x is extra commentary, e.g. ‘local’, for page foot 
center; v alters page foot left, e.g. “4th Berkeley Distribution’; m alters page head 
center, e.g. “Brand X Programmer’s Manual’. Set prevailing indent and tabs to .51. 
Set prevailing indent to i. Begin indented paragraph with hanging tag given by next 
text line. If tag doesn’t fit, place it on separate line. 


* ntl. = next text line; p.i. = prevailing indent 
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NAME 
me — macros for formatting papers 


SYNOPSIS 
nroff —me [ options ] file ... 
troff—me [ options ] file ... 


DESCRIPTION 
This package of nroff and troff macro definitions provides a canned formatting facility for technical papers 
in various formats. When producing 2-column output on a terminal, filter the output through co/(1). 


The macro requests are defined below. Many nroff and troff requests are unsafe in conjunction with this 
package, however, these requests may be used with impunity after the first .pp: 


.bp begin new page 

-br —_— break output line here 

.spn_ insert n spacing lines 

sn (line spacing) n=1 single, n=2 double space 
na —s no alignment of right margin 

.cen center next n lines 

.uln underline next n lines 

.sz +n add n to point size 


Output of the eqn, neqn, refer, and tbl(1) preprocessors for equations and tables is acceptable as input. 


FILES 
/usr/lib/tmac/tmac.e 
/ustr/lib/me/* 

SEE ALSO 


eqn(1), troff(1), refer(1), tbl(1) 
—me Reference Manual, Eric P. Allman 
Writing Papers with Nroff Using —me 
REQUESTS 
In the following list, ‘‘initialization’’ refers to the first .pp, Ip, .ip, .np, .sh, or .uh macro. This list is incom- 
plete; see The —me Reference Manual for interesting details. 


Request _ Initial Cause Explanation 


Value Break 
Ac - yes Begin centered block 
Ad - no _ Begin delayed text 
Af - no _ Begin footnote 
AL - yes Begin list 
(q - yes Begin major quote 
(XX - no _ Begin indexed item in index x 
(Z - no _ Begin floating keep 
.)c - yes End centered block 
dd - yes End delayed text 
Sf - yes End footnote 
a) I - yes End list 
)q - yes End major quote 
.)X - yes End index item 
JZ - yes End floating keep 
++mH - no Define paper section. m defines the part of the paper, and can be C (chapter), A (appendix), 


P (preliminary, e.g., abstract, table of contents, etc.), B (bibliography), RC (chapters 
renumbered from page one each chapter), or RA (appendix renumbered from page one). 
tc T - yes Begin chapter (or appendix, etc., as set by .++). Tis the chapter title. 
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EQ xy 


Xp x 


no 


Pore 
Pree 
Pore 


Pere 


Pree 


Pree 
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One column format on a new page. 

Two column format. 

Space after equation produced by eqn or neqn. 

Precede equation; break out and add space. Equation number is y. The optional argument 
x may be / to indent equation (default), L to left-adjust the equation, or C to center the equa- 
tion. 

End gremlin picture. 

Begin gremlin picture. 

End pic picture. 

Begin pic picture. 

End table. 

End heading section of table. 

Begin table; if x is H table has repeated heading. 

Set up for ACM style output. A is the Author’s name(s), N is the total number of pages. 
Must be given before the first initialization. 

Print x in boldface; if no argument switch to boldface. 

Augments the base indent by n. This indent is used to set the indent on regular text (like 
paragraphs). 

Begin new column 

Print x in bold italics (nofill only) 

Begin bulleted paragraph 

Print x in a box (nofill only). 

Set even footer tox y z 

Set even header tox y z 

Set footer tox y z 

Suppress headers and footers on next page. 

Set header tox y z 

Draw a horizontal line 

Italicize x; if x missing, italic text follows. 

Start indented paragraph, with hanging tag x. Indentation is y ens (default 5). 

Start left-blocked paragraph. 

Read in a file of local macros of the form .*x. Must be given before initialization. 

Start numbered paragraph. 

Set odd footer to x y z 

Set odd header to x y z 

Print delayed text. 

Begin paragraph. First line indented. 

Roman text follows. 

Reset tabs to default values. 

Read in a file of special characters and diacritical marks. Must be given before initializa- 
tion. 

Section head follows, font automatically bold. 7 is level of section, x is title of section. 
Leave the next page blank. Only one page is remembered ahead. 

Set x in a smaller pointsize. 

Augment the point size by n points. 

Produce the paper in thesis format. Must be given before initialization. 

Begin title page. 

Underline argument (even in troff). (Nofill only). 

Like .sh but unnumbered. 

Print index x. 


3rd Berkeley Distribution May 6, 1986 2 


MS (7) UNIX Programmer’s Manual 


NAME 
ms — text formatting macros 


SYNOPSIS 
nroff —ms [ options ] file ... 
troff —ms [ options ] file ... 


DESCRIPTION 


This package of nroff and troff macro definitions provides a formatting facility for various styles of arti- 
cles, theses, and books. When producing 2-column output on a terminal or lineprinter, or when reverse line 
motions are needed, filter the output through col(1). All external -ms macros are defined below. Many 
nroff and troff requests are unsafe in conjunction with this package. However, the first four requests below 
may be used with impunity after initialization, and the last two may be used even before initialization: 


-bp begin new page 

-br break output line 

spn insert n spacing lines 

.cen center next n lines 

Asn line spacing: n=1 single, n=2 double space 
na no alignment of right margin 


Font and point size changes with \f and \s are also allowed; for example, “‘\flword\fR’’ will italicize word. 
Output of the tb/, eqn, and refer(1) preprocessors for equations, tables, and references is acceptable as 


input. 


FILES 


/usr/lib/tmac/tmac.x 


/usr/lib/ms/x.??? 


SEE ALSO 
eqn(1), refer(1), tbl(1), troff(1) 
REQUESTS 
Macro Initial Break? Explanation 
Name Value Reset? 
.AB x - y begin abstract; if x=no don’t label abstract 
.AE - y end abstract 
Al - y author’s institution 
AM - n better accent mark definitions 
.AU - y author’s name 
Bx - n embolden x; if no x, switch to boldface 
.B1 - y begin text to be enclosed in a box 
.B2 - y end boxed text and print it 
.BT date n bottom title, printed at foot of page 
.BX x - n print word x in a box 
.CM if t n cut mark between pages 
.CT - yoy chapter title: page number moved to CF (TM only) 
.DA x ifn n force date x at bottom of page; today if no x 
.DE - y end display (unfilled text) of any kind 
DSxy I y begin display with keep; x=I,L,C,B; y =indent 
ID y 8n,.51 oy indented display with no keep; y=indent 
.LD - y left display with no keep 
.CD - y centered display with no keep 
.BD - y block display; center entire block 
.EF x - n even page footer x (3 part as for .tl) 
.EH x - n even page header x (3 part as for .tl) 
.EN - y end displayed equation produced by eqn 
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break out equation; x=L,I,C; y=equation number 
end footnote to be placed at bottom of page 
numbered footnote paragraph; may be redefined 
start footnote; x is optional footnote label 

optional page header below header margin 

italicize x; if no x, switch to italics 

indented paragraph, with hanging tag x; y=indent 
index words x y and so on (up to 5 levels) 

end keep of any kind 

begin floating keep; text fills remainder of page 
begin keep; unit kept together on a single page 
larger; increase point size by 2 

left (block) paragraph. 

multiple columns; x=column width 

no date in page footer; x is date on cover 

numbered header; x =level, x =0 resets, x=S sets to y 
set point size back to normal 

odd page footer x (3 part as for .tl) 

odd page header x (3 part as for .tl) 

print header on Ist page 

paragraph with first line indented 

page title, printed at head of page 

print index (table of contents); x=no suppresses title 
quote paragraph (indented and shorter) 

return to Roman font 

retreat: end level of relative indentation 

released paper format; x=no stops title on Ist page 
right shift: start level of relative indentation 

section header, in boldface 

smaller; decrease point size by 2 

set tabs to 8n 16n ... (nroff) 5n 10n ... (troff) 

print table of contents at end; x=no suppresses title 
end of table processed by tb/ 

end multi-page header of table 

title in boldface and two points larger 

UC Berkeley thesis mode 

begin table; if x =H table has multi-page header 
underline x, even in troff 

UNIX; trademark message first time; x appended 
another index entry; x =page or no for none; y=indent 
end index entry (or series of .[X entries) 

paragraph with first line exdented, others indented 
begin index entry; x=page or no for none; y=indent 
one column format, on a new page 

begin two column format 

beginning of refer reference 

end of unclassifiable type of reference 

N= 1:journal-article, 2:book, 3:book-article, 4:report 
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REGISTERS 
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Formatting distances can be controlled in —ms by means of built-in number registers. For example, this sets 


the line length to 6.5 inches: 
nr LL 6.51 
Here is a table of number registers and their default values: 


Name Register Controls Takes Effect Default 


PS point size paragraph 10 
VS _verticalspacing paragraph 12 
LL line length paragraph 61 
LT _ title length next page sameas LL 


FL footnote length next .FS 5.54 

PD paragraph distance paragraph lv (if n), .3v (if t) 
DD display distance displays lv (if n), .5v (if t) 
PI paragraph indent paragraph 5n 


QI quote indent next .QP 5n 
FI footnote indent next .FS 2n 
PO page offset next page 0 (ifn), ~li (ift) 
HM header margin next page = li 
FM _ footer margin next page li 


FF footnote format next .FS 0 (1, 2, 3 available) 


When resetting these values, make sure to specify the appropriate units. Setting the line length to 7, for 
example, will result in output with one character per line. Setting FF to 1 suppresses footnote superscript- 
ing; setting it to 2 also suppresses indentation of the first line; and setting it to 3 produces an .IP-like foot- 


note paragraph. 
Here is a list of string registers available in —ms; they may be used anywhere in the text: 
Name String’s Function 
\*Q quote ("in nroff, ‘* in troff ) 
\*U unquote ("in nroff, ’’ in troff) 
\x- dash (-- in nroff, — in troff ) 


\*(MO — month (month of the year) 
\*(DY day (current date) 


\#e automatically numbered footnote 
\*7 acute accent (before letter) 

\ grave accent (before letter) 

\*, circumflex (before letter) 

\*, cedilla (before letter) 

\*: umlaut (before letter) 

\* tilde (before letter) 


When using the extended accent mark definitions available with .AM, these strings should come after, 


rather than before, the letter to be accented. 


BUGS 


Floating keeps and regular keeps are diverted to the same space, so they cannot be mixed together with pre- 


dictable results. 
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NAME 
term — conventional names for terminals 


DESCRIPTION 
Certain commands use these terminal names. They are maintained as part of the shell environment (see 
sh(1),environ(7)). 
adm3a Lear Seigler Adm-3a 
2621 Hewlett-Packard HP262? series terminals 


hp Hewlett-Packard HP264? series terminals 

c100 Human Designed Systems Concept 100 

h19 Heathkit H19 

mime Microterm mime in enhanced ACT IV mode 
1620 DIABLO 1620 (and others using HyType II) 

300 DASI/DTC/GSI 300 (and others using HyType I) 
33 TELETYPE® Model 33 

37 TELETYPE Model 37 

43 TELETYPE Model 43 

735 Texas Instruments TI735 (and TI725) 

745 Texas Instruments T1745 

dumb terminals with no special features 

dialup a terminal on a phone line with no known characteristics 


network a terminal on a network connection with no known characteristics 
4014 Tektronix 4014 
vt52 Digital Equipment Corp. VT52 


The list goes on and on. Consult /etc/termcap (see termcap(5)) for an up-to-date and locally correct list. 


Commands whose behavior may depend on the terminal either consult TERM in the environment, or accept 
arguments of the form —Tterm, where term is one of the names given above. 


SEE ALSO 
stty(1), tabs(1), plot(1G), sh(1), environ(7) ex(1), clear(1), more(1), ul(1), tset(1), termcap(5), termcap(3X), 
ttytype(S) 
troff(1) for nroff 

BUGS 


The programs that ought to adhere to this nomenclature do so only fitfully. 
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